Echo MCP Server For Testing

🚀 回顯 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 文件。