模型上下文协议服务器

测试MCP服务器

Python中的一个简单测试MCP（模型上下文协议）服务器实现，旨在与Claude Desktop配合使用。

特性

此MCP服务器提供：

工具

• 回声：回显输入文本
• 计算：执行基本算术计算
• 获取时间：获取当前日期和时间

资源

• test://example：一个简单的示例资源
• test://server-info：JSON格式的服务器信息

先决条件

• Python 3.11或更高版本
• 紫外线 -快速Python包管理器

设置

1. 安装uv （如果尚未安装）：

   复制

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

2. 运行安装脚本:

   复制

   chmod +x setup.sh
   ./setup.sh
   

   或手动：

   复制

   uv venv
   uv sync
   

运行服务器

要运行MCP服务器，请执行以下操作：

./run.sh

或手动：

uv run python server.py

服务器使用stdio传输，因此它通过标准输入/输出进行通信。

Claude桌面配置

自动配置（推荐）

配置Claude Desktop最简单的方法是使用提供的配置脚本：

./configure_claude.sh

或手动：

uv run python configure_claude.py

此脚本将自动执行以下操作：

• 阅读您现有的Claude Desktop配置
• 使用正确的路径添加或更新MCP服务器配置
• 保留您可能已配置的任何现有MCP服务器
• 如果配置文件不存在，则创建它

运行脚本后，重新启动Claude Desktop以连接到服务器。

手动配置

或者，您可以手动将以下配置添加到Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

视窗: %AppData%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "test-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/Test_MCP_Server_001",
        "run",
        "python",
        "server.py"
      ]
    }
  }
}

重要：替换 /absolute/path/to/Test_MCP_Server_001 带有此项目目录的实际绝对路径。

本地测试

您可以通过运行服务器并通过stdin发送JSON-RPC消息来手动测试服务器。然而，最简单的测试方法是在配置后通过Claude Desktop。

工具使用示例

通过Claude Desktop连接后，您可以使用以下工具：

• 回声：“使用带有文本‘你好，MCP！’的回显工具”
• 计算：“计算15*23+7”
• 获取时间：“现在几点了？”或“以可读格式获取当前时间”

资源访问示例

• 访问示例资源： test://example
• 获取服务器信息： test://server-info

项目结构

Test_MCP_Server_001/
├── server.py              # Main MCP server implementation
├── configure_claude.py    # Script to configure Claude Desktop
├── configure_claude.sh    # Bash script to run configure_claude.py
├── run.sh                 # Bash script to run the server
├── pyproject.toml         # Project configuration and dependencies
├── setup.sh               # Setup script for environment
├── README.md              # This file
└── .gitignore             # Git ignore patterns

发展

要修改服务器，请执行以下操作：

1. 编辑 server.py 添加新工具或资源
2. 更新 pyproject.toml 如果你需要额外的依赖关系
3. 跑 uv sync 更新依赖关系
4. 重新启动Claude Desktop以重新加载服务器

许可证

这是一个用于演示的测试服务器。