🚀 Build Custom MCP Servers 📝☀️📰

🚀 构建自定义 MCP 服务 📝☀️📰

📖 项目描述

本项目演示了如何使用 MCP mcp[cli] Python SDK 构建简单的 MCP 服务。它通过 MCP 服务提供了多个工具：

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

项目使用存储在 .env 文件中的 API 密钥访问外部服务。

🛠️ 设置说明

按照以下步骤运行 FastMCP Agent：

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.lock 假设使用 uv，否则请调整为 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. 运行 Agent：

   • 执行主脚本：

     mcp install main.py
     

   • FastMCP 服务应会添加到 Claude Desktop。

     mcp dev main.py
     

   • 调试 MCP 服务

✨ 功能

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

🤝 贡献

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