Echo MCP Server

🚀 聲 MCP 服務器

聲 MCP 服務器是一個簡單的基於 Model Context Protocol (MCP) 的回聲服務器實現，通過 MCP 接口提供基本的回顯功能，為相關應用提供了便捷的消息回顯服務。

🚀 快速開始

回聲 MCP 服務器使用 .NET Core 構建，採用 Model Context Protocol C# SDK（github.com/modelcontextprotocol/csharp-sdk）。它提供了一個工具，用於將消息原樣返回給客戶端。該服務器設計輕量，展示瞭如何使用 MCP 創建具有簡單功能的自定義服務器，並且可以部署在本地機器或 Docker 容器中。

✨ 主要特性

• 回顯任何消息給客戶端
• 通過配置可自定義的消息格式
• 基於 Model Context Protocol 標準構建

📦 安裝指南

先決條件

• .NET 9.0（用於本地開發/部署）
• Docker（用於容器部署）

開發構建說明

如果要從源代碼構建項目：

1. 克隆此倉庫：

   git clone https://github.com/yourusername/echo-mcp-server.git
   

2. 切換到項目根目錄：

   cd echo-mcp-server
   

3. 使用以下命令構建項目：

   dotnet build src/echo.sln
   

4. 運行測試：

   dotnet test src/echo.sln
   

Docker 支持

手動構建 Docker 鏡像

要自己構建 Docker 鏡像：

# 切換到倉庫根目錄
cd echo-mcp-server

# 構建 Docker 鏡像
docker build -f src/Core.Infrastructure.McpServer/Dockerfile -t echo-mcp-server:latest src/

# 運行本地構建的鏡像
docker run -d --name echo-mcp echo-mcp-server:latest

💻 使用示例

客戶端配置

要在客戶端上配置回聲服務器，請將以下內容添加到你的 appsettings.json 文件中：

{
  "McpEchoOptions": {
    "Address": "tcp://localhost:5001"
  }
}

🔧 技術細節

配置

環境變量

可以通過設置以下環境變量來配置回聲服務器的行為：

• ECHO_MESSAGE: 要顯示的自定義消息。
• ECHO_COLOR: 消息的顏色（支持 ANSI 顏色代碼）。

例如，要在控制檯以紅色顯示“Hello, World!”：

docker run -e ECHO_MESSAGE="Hello, World!" -e ECHO_COLOR=31 echo-mcp-server:latest

文件配置

你還可以通過創建一個自定義的 appsettings.json 文件來配置服務器。例如：

{
  "McpEchoOptions": {
    "Message": "你好，世界！",
    "Color": "32"
  }
}

然後，在運行容器時掛載此文件：

docker run -v /path/to/custom-settings.json:/app/appsettings.json echo-mcp-server:latest

📄 許可證

該項目在 MIT License 下許可，詳細信息見 LICENSE 文件。