🚀 构建自定义 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 # 或者如果直接使用 pyproject.toml，则使用 uv sync
     # 如果不使用 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 Search 集成，用于新闻搜索 📰
• 通过 .env 文件进行配置 🔑
• 使用 mcp[cli] 构建 ⚙️

🤝 贡献

欢迎贡献！请随时提交 pull request 或打开 issue。