MCP Echo 服务器

概述

MCP Echo 服务器是一个轻量级的基于 Python 的微服务，旨在提供简单的回显功能。它接收消息并将它们返回给客户端，作为 MCP 框架内的基本诊断和测试工具。

项目详情

• 版本: 0.1.0
• Python 兼容性: Python 3.11+

功能

• 消息回显: 返回发送到服务器的任何消息
• 全面验证: 使用 Pydantic 模型进行强大的输入验证
• 异步服务器架构: 使用 asyncio 构建，以实现高效性能
• 灵活配置: 可通过环境变量和配置文件进行配置

依赖项

核心依赖项:

• mcp (>=1.6.0)
• pydantic (>=2.11.2)
• PyYAML (>=6.0.2)

开发依赖项:

• pytest (>=8.3.5)

安装

前提条件

• Python 3.11 或更高版本
• pip
• (可选) 推荐使用虚拟环境

从 PyPI 安装

pip install chuk-mcp-echo-server

从源码安装

1. 克隆仓库:

git clone <repository-url>
cd chuk-mcp-echo-server

2. 创建一个虚拟环境:

python -m venv venv
source venv/bin/activate  # 在 Windows 上，使用 `venv\Scripts\activate`

3. 安装包:

pip install .  # 以可编辑模式安装包

开发安装

要设置进行开发:

pip install .[dev]  # 安装包含开发依赖项的包

运行服务器

命令行界面

chuk-mcp-echo-server

编程方式使用

from chuk_mcp_echo_server.main import main

if __name__ == "__main__":
    main()

环境变量

• NO_BOOTSTRAP: 设置为禁用组件引导
• 其他配置选项可以在配置文件中设置

可用工具

Echo

输入:

• message: 要回显的字符串消息

示例:

echo("Hello, world!")

返回:

• 原始消息，以 EchoResult 对象形式返回

开发

代码格式化

• Black 用于代码格式化
• isort 用于导入排序
• 行长度设置为 88 个字符

运行测试

pytest

贡献

1. Fork 仓库
2. 创建您的功能分支 (git checkout -b feature/AmazingFeature)
3. 确保代码通过格式化和测试
4. 提交您的更改 (git commit -m 'Add some AmazingFeature')
5. 推送到分支 (git push origin feature/AmazingFeature)
6. 打开一个 Pull Request

许可证

MIT 许可证