admin-valentin/openai-agents-python
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
openai-agents-python/examples/mcp/filesystem_example
History
Rohan Mehta 010022777b [5/n] MCP tracing 
## Summary:

Adds tracing and tests for tracing.
- Tools are added to the agents
- Theres a span for the mcp tools lookup
- Functions have MCP data

## Test Plan:

Unit tests
.
2025-03-25 19:28:48 -04:00
..
sample_files [3/n] Add an MCP stdio example 2025-03-25 13:24:18 -04:00
main.py [5/n] MCP tracing 2025-03-25 19:28:48 -04:00
README.md [3/n] Add an MCP stdio example 2025-03-25 13:24:18 -04:00

README.md

MCP Filesystem Example

This example uses the fileystem MCP server, running locally via npx.

Run it via:

uv run python  python examples/mcp/filesystem_example/main.py

Details

The example uses the MCPServerStdio class from agents, with the command:

npx -y "@modelcontextprotocol/server-filesystem" <samples_directory>

It's only given access to the sample_files directory adjacent to the example, which contains some sample data.

Under the hood:

  1. The server is spun up in a subprocess, and exposes a bunch of tools like list_directory(), read_file(), etc.
  2. We add the server instance to the Agent via mcp_agents.
  3. Each time the agent runs, we call out to the MCP server to fetch the list of tools via server.list_tools().
  4. If the LLM chooses to use an MCP tool, we call the MCP server to run the tool via server.run_tool().