MCP Forge

🚀 MCP-Forge

MCP-Forge 是一款腳手架工具，可用於快速搭建新的 MCP（模型上下文協議）服務器項目。它會生成一個結構良好的項目，其中包含示例工具、資源和測試工具，讓您能夠專注於服務器功能的構建。

🚀 快速開始

MCP-Forge 能幫助您迅速開啟 MCP 服務器項目的搭建。以下為您詳細介紹使用步驟。

創建新項目

要創建一個新的 MCP 服務器項目，請運行以下命令：

mcp-forge new my-awesome-server
cd my-awesome-server

啟動服務器

要啟動服務器，請執行以下命令：

uv run python -m my_awesome_server.server --mode=sse

或者，如果您已進入項目目錄：

my-awesome-server --mode=sse  # 在 SSE 模式下運行（HTTP 服務在 0.0.0.0:6969）
my-awesome-server --mode=stdio # 在 stdio 模式下運行

✨ 主要特性

• 生成完整的 Python 項目結構，專門用於 MCP 服務器。
• 提供統一的服務器入口點，並可通過 --mode 參數選擇 SSE 和 stdio 傳輸模式。
• 包含示例工具（如 AddNumbers、DateDifference 等）和資源（如 HelloWorld、UserProfile）。
• 使用 Pydantic 模型定義清晰的輸入/輸出架構。
• 使用 uv 進行依賴管理及任務運行。

📦 安裝指南

推薦使用 uvx（來自 uv），它能處理臨時環境：

# 確保安裝了 uv
uvx mcp-forge --help

或者，您也可以全局安裝或在專用環境中使用 pip：

pip install mcp-forge
mcp-forge --help

📚 詳細文檔

項目結構

生成的項目結構如下：

my_awesome_server/
├── server.py             # 主服務器文件
├── tools/               # 自定義工具目錄
│   └── __init__.py      # 工具初始化文件
├── resources/           # 資源目錄
│   └── __init__.py      # 資源初始化文件
└── requirements.txt     # 項目依賴管理文件

關於 MCP

模型上下文協議（MCP）是一項規範，用於實現語言模型（或其他客戶端）與外部工具/服務（服務器）之間的通信。它定義了服務器如何以標準方式暴露工具和資源。 瞭解更多信息，請訪問 MCP 官方文檔。

支持開發

如果您發現此項目有用，請考慮通過捐贈支持其開發： 您的支持將有助於維護和改進該項目！

貢獻

歡迎為 MCP-Forge 做出貢獻！這是一個早期項目，有很多改進和新功能的空間。

1. 分叉倉庫（mcp-forge）
2. 創建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m '添加一些很棒的功能'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 打開 Pull Request

📄 許可證

該項目在 MIT 許可證下開源。有關詳細信息，請查看生成的 LICENSE 文件或源倉庫。

⚠️ 重要提示

這是 MCP-Forge 的早期版本。API、生成的結構和功能可能會隨著 MCP 生態系統的演變而發生變化。歡迎反饋和貢獻！