Contact Book MCP Server

一个简单的 Model Context Protocol (MCP) 服务器，用于管理内存通讯录。使用 mcp Python SDK 中的 FastMCP 构建。

功能

该服务器提供四个工具：

联系人以如下形式存储在内存中：

contacts: dict[str, dict]  # name -> {"phone": ..., "email": ...}

注意： 数据仅存储在内存中。服务器重启后，所有联系人都会丢失。

Related MCP server: mcp-outlook-contacts

环境要求

• Python 3.10+

• uv（推荐用于运行服务器）

安装

1. 克隆此仓库：

   git clone <your-repo-url>
   cd contact_book_server_mcp

2. 安装依赖：

   pip install -r requirements.txt

   或者，如果使用 uv（推荐，无需手动安装——参见下文）。

运行服务器

使用 MCP Inspector（用于测试/开发）

uv run --with mcp mcp dev server.py

这将启动服务器，并在浏览器中打开 MCP Inspector，你可以在此交互式地测试每个工具。

独立运行

python server.py

示例用法

1. 添加联系人

   add_contact(name="Humna Fahad", phone="03001234567", email="humna@test.com")
   → "Contact 'Humna Fahad' added successfully."

2. 获取联系人

   get_contact(name="Humna Fahad")
   → {"name": "Humna Fahad", "phone": "03001234567", "email": "humna@test.com"}

3. 搜索联系人

   search_contacts(query="Hum")
   → [{"name": "Humna Fahad", "phone": "03001234567", "email": "humna@test.com"}]

4. 更新联系人

   update_contact(name="Humna Fahad", phone="03009998888", email="humna@updated.com")
   → "Contact 'Humna Fahad' updated successfully."

项目状态

✅ 所有四个工具均已实现，并已通过 MCP Inspector 测试。

可能的改进

• 添加 delete_contact 工具。

• 添加 list_all_contacts 工具。

• 将联系人持久化到 JSON 文件或数据库中，而不是存储在内存中。