Chuk MCP Echo Server

🚀 MCP 回聲服務器

MCP 回聲服務器是一款基於 Python 的輕量級微服務，主要用於提供簡單的回聲功能。它能接收消息並將其返回給客戶端，是 MCP 框架中基礎的診斷和測試工具。

🚀 快速開始

運行服務器

命令行界面

chuk-mcp-echo-server

編程式使用

from chuk_mcp_echo_server.main import main

if __name__ == "__main__":
    main()

✨ 主要特性

• 消息回聲：返回任何發送到服務器的消息。
• 全面驗證：使用 Pydantic 模型進行強大的輸入驗證。
• 異步服務器架構：使用 asyncio 構建，性能高效。
• 靈活配置：通過環境變量和配置文件進行配置。

📦 安裝指南

先決條件

• 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]  # 使用開發依賴項安裝包

💻 使用示例

基礎用法

echo("Hello, world!")

📚 詳細文檔

項目細節

依賴項

核心依賴項

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

開發依賴項

• pytest (>=8.3.5)

環境變量

• NO_BOOTSTRAP：設置以禁用組件啟動引導。
• 其他配置選項可以在配置文件中設置。

可用工具 - 回聲

輸入：

• message：要回顯的字符串消息。

返回：

• 一個 EchoResult 對象，包含原始消息。

開發

代碼格式化

• 使用 Black 進行代碼格式化。
• 使用 isort 進行導入排序。
• 行長度設置為 88 個字符。

運行測試

pytest

貢獻

1. 叉取倉庫。
2. 創建功能分支 (git checkout -b feature/AmazingFeature)。
3. 確保代碼通過格式檢查和測試。
4. 提交更改 (git commit -m 'Add some AmazingFeature')。
5. 推送到分支 (git push origin feature/AmazingFeature)。
6. 打開 Pull Request。

📄 許可證

MIT License