AI导哈

MCP服务器工具

一个简单的MCP服务器，提供文本处理、文件操作和计算等基本实用工具，可扩展Claude AI桌面应用的功能。

  • by eshvargb
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 eshvargb/MCP_ClaudeAI

使用说明

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

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

特性

可用工具：

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

快速设置

  1. 运行安装脚本：

    ./setup.sh

  2. 或手动设置：

    # 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

  2. Claude未显示MCP工具

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

  3. 服务器无法启动

    • 确保已安装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()在生产环境中，您应该用更安全的数学表达式解析器替换它。

许可证

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

相关 MCP