My MCP Server

My MCP Server

site icon
2025.04.17 0
PythonGoogle 搜索内存存储搜索工具开发效率
My MCP Server 是一个基于 Python 和 FastMCP 实现的简单模型上下文协议(MCP)服务器。该服务器主要为 MCP 客户端(如 Claude)提供两种核心能力:Google 搜索和内存存储。Google 搜索功能允许客户端通过自定义搜索 API 执行搜索操作,而内存存储功能则允许客户端在本地 JSON 文件中存储和检索简单的键值对记忆。
View on GitHub

Overview

基本能力

产品定位

My MCP Server 是一个为 MCP 客户端提供搜索和内存存储功能的支持服务器。

核心功能

  1. Google 搜索:通过 Google 自定义搜索 API 执行搜索操作。
  2. 内存存储:在本地 JSON 文件中存储和检索键值对记忆。

适用场景

  1. 需要集成 Google 搜索功能的 MCP 客户端。
  2. 需要简单键值对存储功能的 MCP 客户端。

工具列表

  1. Google Search Tool:通过 Google 自定义搜索 API 执行搜索。
  2. Memory Store Tool:在本地 JSON 文件中存储和检索键值对。

常见问题解答

  1. 如何获取 Google API 密钥和 CSE ID?
  2. API 密钥可以从 Google Cloud Console 获取,需要启用 Custom Search API。
  3. CSE ID 可以从 Programmable Search Engine control panel 获取。
  4. 服务器启动失败怎么办?
  5. 确保已正确安装所有依赖项,并已激活虚拟环境。
  6. 检查 .env 文件中的 API 密钥和 CSE ID 是否正确配置。

使用教程

使用依赖

  1. Python 3.11+
  2. uv(Python 包安装器和虚拟环境管理器)
  3. PowerShell (Windows): powershell powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  4. Shell (macOS, Linux): bash curl -LsSf https://astral.sh/uv/install.sh | sh

安装教程

  1. 克隆仓库 bash git clone <your-repository-url> cd my-mcp
  2. 创建并激活虚拟环境 bash 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
  3. 安装依赖 bash uv pip sync pyproject.toml
  4. 配置环境变量
  5. 在根目录创建 .env 文件,并添加以下内容: env GOOGLE_API_KEY="YOUR_GOOGLE_API_KEY_HERE" GOOGLE_CSE_ID="YOUR_GOOGLE_CSE_ID_HERE"

调试方式

  1. 启动服务器 bash uv run main.py
  2. 检查日志
  3. 服务器会将日志信息输出到标准错误,包括 API 密钥缺失或工具注册状态的警告。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。