MCP服务器

我的MCP服务器

使用Python实现的简单模型上下文协议（MCP）服务器 FastMCP.

此服务器为MCP客户端（如Claude）提供以下功能：

• 谷歌搜索： 允许客户端通过自定义搜索API执行Google搜索。
• 内存存储： 允许客户端存储和检索保存在本地JSON文件中的简单键值记忆(data/memories.json).

先决条件

• Python 3.11+
• 紫外线 （Python包安装程序和虚拟环境管理器）
• Google搜索工具的Google API密钥和自定义搜索引擎（CSE）ID。

设置

1. 安装 uv:

   • PowerShell（Windows）：
     复制

     powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
     

   • Shell（macOS、Linux）：
     复制

     curl -LsSf https://astral.sh/uv/install.sh | sh
     

2. 克隆存储库：

   复制

   git clone <your-repository-url>
   cd my-mcp
   

3. 创建和激活虚拟环境：

   复制

   uv venv
   # Activate the environment:
   # Windows (CMD): .venv\Scripts\activate.bat
   # Windows (PowerShell): .venv\Scripts\Activate.ps1
   # macOS/Linux (Bash/Zsh): source .venv/bin/activate
   

4. 安装依赖关系：

   复制

   uv pip sync pyproject.toml
   

   （这将安装在您的 pyproject.toml)

5. 配置环境变量：

   • 创建一个名为的文件 .env 在根目录中(my-mcp).
   • 将您的Google API凭据添加到 .env 文件：
     复制

     GOOGLE_API_KEY="YOUR_GOOGLE_API_KEY_HERE"
     GOOGLE_CSE_ID="YOUR_GOOGLE_CSE_ID_HERE"
     

   • 将占位符值替换为您的实际密钥和ID。您可以从 谷歌云控制台 （API密钥，启用自定义搜索API）和 可编程搜索引擎控制面板 （搜索引擎ID）。

运行服务器

确保您的虚拟环境已激活。然后，运行主脚本：

uv run main.py

服务器将使用标准输入/输出启动并监听来自MCP客户端的连接(stdio).服务器将消息（包括有关缺少API密钥或工具注册状态的警告）记录为标准错误。