MCP服务器

MCP 简易版

用Python编写的简单MCP服务器。

安装

通过uvx（推荐）

用于安装和启动服务器，请使用 uvx这将允许在不全局安装包的情况下启动服务器。

对于公开仓库：

uvx mcp-simple

对于私有仓库：

uvx --from git+https://oauth2:YOUR_GITHUB_TOKEN@github.com/YOUR_USERNAME/mcp-simple.git mcp-simple

替换 YOUR_GITHUB_TOKEN 在您的GitHub上获取一个具有读取仓库权限的个人访问令牌，并且 YOUR_USERNAME 以您的GitHub用户名为准。

通过 pip 的替代安装方法

如果您更倾向于本地安装：

pip install -e .

设置环境变量

1. 复制文件 .env.example 在（注：此句“в”在俄语中是一个介词，通常用于表示位置、方向或时间等，单独使用时可能需要根据上下文来确定具体含义，这里直接翻译为“在”作为通用表达） .env:

   复制

   cp .env.example .env
   

2. 打开文件 .env 并填写必要的数值：

   复制

   # Настройки сервера
   SERVER_HOST=localhost
   SERVER_PORT=8000
   
   # База данных
   DATABASE_URL=sqlite:///mcp_simple.db
   
   # API ключи (если нужны)
   # API_KEY=your_api_key_here
   

   • SERVER_HOST将运行服务器的主机（默认为localhost）
   • SERVER_PORT服务器端口（默认8000）
   • DATABASE_URL数据库URL（默认为SQLite）
   • API_KEY您的API密钥，如需用于外部服务

Claude Desktop的配置

要在 Claude Desktop 中使用 MCP 服务器，请将以下配置添加到文件中 claude_desktop_config.json （通常位于 ~/Library/Application Support/Claude/ 在 macOS 或 %APPDATA%\Claude\ （在Windows上）。

私有仓库的配置示例：

{
  "mcpServers": {
    "mcp-simple": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://oauth2:YOUR_GITHUB_TOKEN@github.com/YOUR_USERNAME/mcp-simple.git",
        "mcp-simple"
      ],
      "env": {
        "SERVER_HOST": "localhost",
        "SERVER_PORT": "8000",
        "DATABASE_URL": "sqlite:///mcp_simple.db"
      }
    }
  }
}

重要备注：

• 确保您的GitHub令牌具有读取私有仓库的权限
• 可以在（配置）部分中重定义环境变量 env 配置
• 更改配置后，请重启Claude Desktop
• 服务器将在Claude Desktop启动时自动运行

使用

设置完成后启动服务器：

uvx --from git+https://oauth2:YOUR_GITHUB_TOKEN@github.com/YOUR_USERNAME/mcp-simple.git mcp-simple

或者，如果是在本地安装的：

python main.py

项目结构

• src/mcp_server/ - 服务器源代码
• tests/ - 测试
• pyproject.toml - 项目配置
• .env.example - 环境变量文件示例