MCP ClaudeAI

简单模型上下文协议（MCP）服务器

一个简单的MCP服务器，为文本操作、文件操作和计算提供基本的实用工具。该服务器可以连接到Claude AI桌面应用程序以扩展其功能。

特性

可用工具：

• 回声：回显您提供的任何文本
• 计算：执行基本的数学计算
• 单词计数：统计文本中的单词、字符和行数
• reverse_text：反转任何文本字符串
• 大写字母：将文本转换为大写
• 列表文件：列出文件和目录
• get_system_info：获取基本系统信息

快速设置

1. 运行安装脚本：

   ./setup.sh

1. 或手动设置：

   # Create virtual environment
   python3 -m venv venv
   source venv/bin/activate

   # Install dependencies
   pip install -r requirements.txt

连接到Claude AI桌面应用程序

步骤1：找到Claude配置目录

配置文件的位置取决于您的操作系统：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

步骤2：更新Claude配置

1. 查找或创建配置文件 在上面的位置
2. 添加MCP服务器配置：

{
  "mcpServers": {
    "simple-mcp-server": {
      "command": "/Users/Projects/MCP/venv/bin/python",
      "args": ["/Users/Projects/MCP/server.py"],
      "env": {}
    }
  }
}

重要：替换 /Users/Projects/MCP/server.py 与您的实际绝对路径 server.py 文件。

步骤3:重新启动克劳德桌面应用程序

完全关闭并重新启动Claude桌面应用程序。

步骤4：测试连接

1. 打开克劳德桌面应用程序
2. 在新的对话中，您应该看到可用的MCP工具
3. 试着让克劳德使用其中一个工具，例如：

- “你能帮我计算15\*23吗？” - “请数一下这段文字中的单词：'你好，世界，这是一场测试'” - “列出当前目录中的文件”

手动测试服务器

您可以直接测试服务器：

# Activate virtual environment
source venv/bin/activate

# Run the server (it will wait for input)
python server.py

服务器使用JSON-RPC协议通过stdio（标准输入/输出）进行通信。

故障排除

常见问题：

1. “无法解析导入mcp”

- 确保您已安装以下要求： pip install -r requirements.txt - 激活您的虚拟环境： source venv/bin/activate

1. Claude未显示MCP工具

- 检查路径是否正确 claude_desktop_config.json 绝对正确 - 确保Claude桌面应用程序已完全重新启动 - 检查克劳德的日志是否有任何错误消息

1. 服务器无法启动

- 确保已安装Python 3.7+ - 检查是否安装了所有依赖项 - 请尝试再次运行安装脚本

不同设置的配置示例：

如果使用conda环境：

{
  "mcpServers": {
    "simple-mcp-server": {
      "command": "conda",
      "args": ["run", "-n", "your_env_name", "python", "/full/path/to/server.py"],
      "env": {}
    }
  }
}

如果使用Python系统：

{
  "mcpServers": {
    "simple-mcp-server": {
      "command": "/usr/bin/python3",
      "args": ["/full/path/to/server.py"],
      "env": {}
    }
  }
}

扩展服务器

要添加新工具，请执行以下操作：

1. 添加新 Tool 定义在 list_tools() 函数
2. 在中添加相应的处理程序 call_tool() 函数
3. 重新启动服务器和Claude桌面应用程序

Claude中的示例用法

连接后，您可以要求Claude：

• “计算144的平方根”
• “数一数这段话中的单词：\[你的文本\]”
• “将此文本转换为大写：hello world”
• “显示主目录中的文件”
• “我的系统信息是什么？”

文件结构

MCP/
├── server.py                    # Main MCP server code
├── requirements.txt             # Python dependencies
├── setup.sh                     # Setup script
├── claude_desktop_config.json   # Example Claude config
├── README.md                    # This file
└── venv/                        # Virtual environment (created by setup)

安全说明

此服务器包括一个基本 calculate 使用Python的函数 eval()在生产环境中，您应该用更安全的数学表达式解析器替换它。

许可证

本项目按原样提供，用于教育和发展目的。