Build-Custom-MCP-Servers

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

本项目展示了利用 MCP mcp[cli] Python SDK 构建的简易 MCP 服务器。它提供了一系列通过 MCP 服务器暴露的实用工具，具体包括：

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

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

🚀 快速开始

本项目展示了使用 MCP mcp[cli] Python SDK 构建的一个简单的 MCP 服务器，提供了笔记管理、天气信息获取和新闻搜索等实用工具。以下是快速开始的步骤。

✨ 主要特性

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

📦 安装指南

按照以下步骤运行 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 服务器

🤝 贡献指南

欢迎大家积极贡献！你可以随意提交拉取请求或打开问题。