https://github.com/messeb/py-mcp-server-explorer-notebook
🧪 Explore and test MCP servers with fastmcp and FastAgent. List tools, invoke APIs, and augment LLMs with real-time capabilities using OpenAI, Claude, and Brave Search.
https://github.com/messeb/py-mcp-server-explorer-notebook
ai-workbench brave-search claude fast-agent-mcp fastmcp jupyter-notebook llm-agents mcp openai python tool-calling
Last synced: 27 days ago
JSON representation
🧪 Explore and test MCP servers with fastmcp and FastAgent. List tools, invoke APIs, and augment LLMs with real-time capabilities using OpenAI, Claude, and Brave Search.
- Host: GitHub
- URL: https://github.com/messeb/py-mcp-server-explorer-notebook
- Owner: messeb
- Created: 2025-05-27T20:28:42.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-27T20:34:30.000Z (about 1 year ago)
- Last Synced: 2025-06-25T14:58:22.637Z (11 months ago)
- Topics: ai-workbench, brave-search, claude, fast-agent-mcp, fastmcp, jupyter-notebook, llm-agents, mcp, openai, python, tool-calling
- Language: Jupyter Notebook
- Homepage:
- Size: 6.84 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🔎 MCP Server Explorer Notebook
An interactive notebook environment to explore, list, and invoke tools from MCP (Model Context Protocol) servers using [`fastmcp`](https://pypi.org/project/fastmcp/) and [`fast-agent-mcp`](https://pypi.org/project/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.
## 🚀 Getting Started
### 1️⃣ Clone the Repository
```bash
git clone https://github.com/messeb/py-mcp-server-explorer-notebook.git
cd py-mcp-server-explorer-notebook
```
## 🔐 Environment Setup
### 2️⃣ Set Up Your API Keys
Rename the provided `example.env` to `.env`:
```bash
mv example.env .env
```
Edit `.env` and fill in your API keys:
```bash
# .env
ANTHROPIC_API_KEY=your_claude_key
OPENAI_API_KEY=your_openai_key
BRAVE_API_KEY=your_brave_key
```
## ⚙️ FastAgent Configuration
### 3️⃣ Configure fastagent.config
Rename `example.fastagent.config` to `fastagent.config.yaml`:
```bash
mv example.fastagent.config fastagent.config.yaml
```
Edit the config to include your environment variables (e.g. for Brave Search):
```yaml
mcp:
servers:
brave_websearch:
command: npx
args: ["-y", "@modelcontextprotocol/server-brave-search"]
env:
BRAVE_API_KEY: ""
```
## 📒 Run the Notebook
Open [mcp-server-explorer-notebook.ipynb](./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`
## 🧠 Credits
Powered by:
- [fast-agent-mcp](https://github.com/evalstate/fast-agent)
- [fastmcp](https://github.com/jlowin/fastmcp)
- [OpenAI](https://platform.openai.com/)
- [Anthropic Claude](https://www.anthropic.com/)
- [Brave Search API](https://brave.com/search/api/)