🚀 自定义MCP服务器构建指南

📖 项目说明

该项目展示了使用 MCP mcp[cli] Python SDK 构建的一个简单的 MCP 服务器。它提供了一些通过 MCP 服务器暴露的工具：

• 笔记管理: 添加、阅读、检索最新笔记以及生成笔记摘要，所有笔记均存储在本地。
• 天气信息: 使用 WeatherAPI.com 服务获取指定城市的当前天气数据。
• 新闻搜索: 使用 Brave Search API 执行新闻搜索。

该项目利用存储在 .env 文件中的 API 密钥来调用外部服务。

🛠️ 安装说明

按照以下步骤运行 FastMCP 代理：

1. 先决条件:

   • 已安装 Python 3.12。
   • 推荐使用虚拟环境管理工具（如 venv、pipenv、poetry 或 uv）。

2. 克隆仓库（如果尚未克隆）:

   # 确保你处于正确的父目录中
   git clone https://github.com/sourangshupal/Build-Custom-MCP-Servers # 或者使用当前目录如果已经克隆
   cd Build-Custom-MCP-Servers 
   

3. 设置虚拟环境及安装依赖项:

   • 安装依赖项（假设使用 uv，基于 uv.lock 文件，否则调整为 pip/poetry）:

     uv sync
     uv lock
     source .venv/bin/activate  # 在 Windows 中使用 `.venv\Scripts\activate`
     

   • 或者

     pip install uv # 如果你没有安装 uv
     uv pip install -r requirements.txt # 或者 uv sync 如果直接使用 pyproject.toml
     # 如果不使用 uv，通常: pip install -r requirements.txt 或 poetry install 或 pip install .
     

4. 配置环境变量:

   • 复制示例环境文件:

     cp .env.example .env
     

   • 编辑新创建的 .env 文件并添加你的 API 密钥:

     WEATHER_API_KEY="YOUR_WEATHER_API_KEY"
     BRAVE_API_KEY="YOUR_BRAVE_API_KEY"
     

5. 运行代理:

   • 执行主脚本:

     mcp install main.py
     

   • FastMCP 服务器应被添加到 Claude Desktop。

     mcp dev main.py
     

   • 调试 MCP 服务器

✨ 功能亮点

• 笔记管理：添加、阅读、查看最新和生成摘要功能 📝
• 天气预报：获取指定城市的当前天气 ☀️
• Brave 搜索集成：用于新闻搜索 📰
• 通过 .env 文件配置：实现密钥管理 🔑
• 使用 mcp[cli] 构建 ⚙️

🤝 贡献指南

欢迎贡献！请随意提交拉取请求或打开问题。