An interactive notebook environment to explore, list, and invoke tools from MCP (Model Context Protocol) servers using fastmcp and fast-agent-mcp.

Ideal for building and testing tool-driven AI agents using LLMs like OpenAI or Claude, augmented by external tool servers like Playwright and Brave Search.

git clone https://github.com/messeb/py-mcp-server-explorer-notebook.git
cd py-mcp-server-explorer-notebook

Rename the provided example.env to .env:

mv example.env .env

Edit .env and fill in your API keys:

# .env
ANTHROPIC_API_KEY=your_claude_key
OPENAI_API_KEY=your_openai_key
BRAVE_API_KEY=your_brave_key

Rename example.fastagent.config to fastagent.config.yaml:

mv example.fastagent.config fastagent.config.yaml

Edit the config to include your environment variables (e.g. for Brave Search):

mcp:
  servers:
    brave_websearch:
      command: npx
      args: ["-y", "@modelcontextprotocol/server-brave-search"]
      env:
        BRAVE_API_KEY: "<KEY>"

Open mcp-server-explorer-notebook.ipynb to:

• List available tools from MCP servers
• Call tools directly (e.g. Brave Search, Playwright)
• Route tool usage through an LLM using FastAgent

Powered by:

• fast-agent-mcp
• fastmcp
• OpenAI
• Anthropic Claude
• Brave Search API