🚀 构建自定义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桌面。

     mcp dev main.py
     

   • 调试MCP服务器

✨ 特性

• 笔记功能（添加、读取、最新、摘要） 📝
• 获取当前天气 ☀️
• Brave Search集成用于新闻 📰
• 通过.env文件配置 🔑
• 使用mcp[cli]构建 ⚙️

🤝 贡献

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