MCP Net

🚀 MCP 工具

本倉庫提供了一系列用於處理模型上下文協議（MCP）的工具，能夠高效地實現請求轉發、可執行文件管理等功能，為 MCP 相關操作提供便利。

🚀 快速開始

MCP 代理

MCP 代理可將從標準輸入讀取的數據轉發至指定的 HTTP 端點，並將響應輸出到標準輸出，實現與遠程兼容服務器的通信。

MCP 服務器

MCP 服務器能加載並管理目錄中的 MCP 可執行文件，通過 HTTP 或標準輸入輸出將其提供給客戶端。

使用 Makefile 構建和運行

項目包含的 Makefile 可簡化組件的構建與運行過程。

✨ 主要特性

MCP 代理

• 請求轉發：將標準輸入的數據轉發到指定 HTTP 端點。
• 簡單易用：實現簡單的代理功能，便於與遠程服務器通信。
• Go 語言編寫：編譯為單個可執行文件，減少部署和運行問題。

MCP 服務器

• 可執行文件管理：從目錄中加載 MCP 可執行文件並提供給客戶端。
• 工具列表返回：客戶端請求時，返回所有已加載 MCP 提供的工具。
• 多模式運行：支持 HTTP 模式和標準輸入模式。

Makefile

• 簡化構建：可構建所有組件或特定組件。
• 便捷運行：提供多種運行模式，方便啟動服務器和代理。

📦 安裝指南

本項目無需複雜的安裝步驟，可通過 Makefile 進行構建。

構建

• 構建所有組件（代理、服務器和示例）：

make

• 僅構建特定組件：

make build-proxy    # 僅構建代理
make build-server   # 僅構建服務器
make build-examples # 僅構建示例 MCP

💻 使用示例

MCP 代理

基礎用法

./mcp-proxy [選項]

選項說明

示例

./mcp-proxy -endpoint="https://api.example.com/mcp" -content-type="application/json"

MCP 服務器

基礎用法

./mcp-server [選項]

選項說明

使用 Makefile 運行

以 HTTP 模式啟動 MCP 服務器

make run-server

以標準輸入輸出模式啟動 MCP 服務器

make run-server-stdio

通過代理連接到本地 MCP 服務器

make run-proxy

構建所有組件並運行服務器和代理

make build && make run

📚 詳細文檔

MCP 目錄結構

服務器期望一個包含可執行文件的目錄，每個可執行文件必須實現使用標準輸入輸出的 MCP 協議。服務器操作流程如下：

1. 掃描目錄中的可執行文件。
2. 運行每個可執行文件以發現它提供的工具。
3. 將這些工具按命名空間名稱（mcpname.toolname）提供給客戶端。

📄 許可證

本項目採用 MIT 許可證授權。