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

本项目展示了如何借助 MCP mcp[cli] Python SDK 构建一个简单的 MCP 服务器。该服务器提供了一系列实用工具，涵盖笔记管理、天气信息获取以及新闻搜索等功能，为用户带来便利。

🚀 快速开始

本项目借助 MCP mcp[cli] Python SDK 构建了一个简单的 MCP 服务器，提供了笔记管理、天气信息获取、新闻搜索等实用工具，所有笔记存储在本地，通过 .env 文件中的 API 密钥调用外部服务。

✨ 主要特性

• 笔记管理：可进行添加、阅读、检索最新笔记以及生成笔记摘要等操作，所有笔记均存储在本地 📝。
• 天气信息：利用 WeatherAPI.com 服务获取指定城市的当前天气数据 ☀️。
• 新闻搜索：通过 Brave Search API 执行新闻搜索 📰。
• 配置灵活：通过 .env 文件配置 API 密钥，实现密钥管理 🔑。
• 构建便捷：使用 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 服务器

🤝 贡献指南

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