mcpField
E
echo-mcp-server-for-testing

echo-mcp-server-for-testing

本地服务
github.com/piebro开发工具380 周前更新

关于 echo-mcp-server-for-testing

用于测试 MCP 客户端的轻量 MCP 服务,也可作为新 MCP 服务的起点。它通过单个回显工具返回输入,便于检查客户端调用。

主要功能

  1. 01用于客户端测试的回显工具
  2. 02新建 MCP 服务的模板

适用场景

  1. 01检查 MCP 客户端的工具调用
  2. 02启动简单的 MCP 服务项目

MCP 相关

向 MCP 客户端提供 `echo_tool`,用于测试。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"echo-mcp-server-for-testing": {
"command": "uvx",
"args": [
"echo-mcp-server-for-testing"
],
"env": {
"SECRET_KEY": "<SECRET_KEY>"
}
}
}
}
启动命令uvx echo-mcp-server-for-testing
需要配置的环境变量
SECRET_KEY密钥

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
pypiecho-mcp-server-for-testing

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

echo-mcp-server-for-testing

一个简单的回显 MCP(模型上下文协议)服务,带有一个简单的 echo_tool,用于测试 MCP 客户端。 它也非常适合作为新 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. 切换到 main 分支并获取当前版本:

    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 许可。详情请参阅 LICENSE 文件。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。