Build Custom MCP Servers

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

📖 项目描述

此项目演示了使用MCP构建的简单MCP服务器 mcp[cli] Python SDK。它提供了通过MCP服务器公开的几个工具：

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

它使用存储在 .env 外部服务文件。

🛠️ 安装说明

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

1. 先决条件：

- 已安装Python 3.12。 - 虚拟环境管理器（如 venv, pipenv, poetry，或 uv)是推荐的。

1. 克隆存储库（如果您还没有）：

   # Make sure you are in the correct parent directory
   git clone https://github.com/sourangshupal/Build-Custom-MCP-Servers # Or use the current directory if already cloned
   cd Build-Custom-MCP-Servers 

1. 设置虚拟环境和安装依赖关系：

- 安装依赖项（假设uv基于uv.lock，否则根据pip/poetry进行调整）：

     uv sync
     uv lock
     source .venv/bin/activate  # On Windows use `.venv\Scripts\activate`

- 或

     pip install uv # if you don't have uv
     uv pip install -r requirements.txt # Or uv sync if using pyproject.toml directly
     # If not using uv, likely: pip install -r requirements.txt or poetry install or pip install .

1. 配置环境变量：

- 复制示例环境文件：

     cp .env.example .env

- 编辑新创建的 .env 文件并添加您的API密钥：

     WEATHER_API_KEY="YOUR_WEATHER_API_KEY"
     BRAVE_API_KEY="YOUR_BRAVE_API_KEY"

1. 运行代理：

- 执行主脚本：

     mcp install main.py

- 应将FastMCP服务器添加到Claude Desktop。

     mcp dev main.py

- 调试MCP服务器

✨ 特性

• 记笔记功能（添加、阅读、更新、总结）📝
• 当前天气获取☀️
• Brave Search新闻集成📰
• 通过配置 .env 文件🔑
• 内置于 mcp[cli] ⚙️

🤝 贡献

欢迎投稿！请随时提交拉取请求或未决问题。