echo-mcp-server-for-testing

一个简单的用于测试MCP（模型上下文协议）客户端的回显MCP服务器，附带一个简单的echo_tool工具。它也是一个创建新MCP服务器的良好模板。

使用方法

安装uv并通过uvx命令将服务器添加到MCP配置中：

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

或者克隆仓库并使用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!"}}'

代码格式化和检查

使用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文件。