🚀 回显 MCP 服务器用于测试

这是一个简单的回显 MCP（模型上下文协议）服务器，配备了 echo_tool 用于测试 MCP 客户端。它还能作为新 MCP 服务器的模板，为开发提供便利。

🚀 快速开始

安装与配置

你可以选择以下两种方式来使用该服务器：

• 使用 uvx 并添加到 MCP 配置：首先安装 uv，然后将服务器添加到 MCP 配置中。配置示例如下：

{
    "name": "echo-mcp-server-for-testing",
    "command": "uvx",
    "args": [
        "echo-mcp-server-for-testing"
    ],
    "env": {
        "SECRET_KEY": "123456789"
    }
}

• 克隆仓库并使用 uv 指定目录：克隆仓库后，使用 uv 并指定项目根目录来运行服务器。配置示例如下：

{
    "name": "echo-mcp-server-for-testing",
    "command": "uv",
    "args": [
        "--directory", 
        "path/to/root/dir/", 
        "run", 
        "main.py"
    ],
    "env": {
        "SECRET_KEY": "123456789"
    }
}

💻 使用示例

测试服务器

克隆仓库后，你可以使用 mcp-client-for-testing 工具来测试服务器，具体命令如下：

uvx mcp-client-for-testing \
    --config '
    [
        {
            "name": "echo-mcp-server-for-testing",
            "command": "uv",
            "args": [
                "--directory", 
                "path/to/root/dir/", 
                "run", 
                "main.py"
            ],
            "env": {
                "SECRET_KEY": "123456789"
            }
        }
    ]
    ' \
    --tool_call '{"name": "echo_tool", "arguments": {"message": "Hello, world!"}}'

🔧 技术细节

格式化与 Linting

使用 ruff 进行代码格式化和检查，确保代码质量：

uv run ruff format
uv run ruff check --fix

构建与 uv

使用 uv 构建包，命令如下：

uv build

发布新版本

要将新版本发布到 PyPI，需要创建并推送到新的 Git 标签，具体步骤如下：

1. 切换到主分支并拉取最新代码：

git checkout main
git pull origin main
git describe --tags

2. 创建并推送新的 Git 标签：

git tag v0.2.0
git push origin v0.2.0

GitHub Actions 工作流会在推送到新标签时自动构建并发布包到 PyPI，Python 包的版本号将直接从 Git 标签中提取。

📄 许可证

本项目遵循 MIT 许可证。有关详细信息，请参阅 LICENSE 文件。