Basicmcpserver

🚀 BasicMcpServer：MCP 服務器實現資源庫

本倉庫主要提供了三項核心功能，為 MCP 服務器的開發、部署和配置提供了全面的支持。一是提供簡單示例 MCP 服務器，你可以直接克隆並按需修改；二是進行 Docker 容器化演示，展示如何在 Docker 中設置帶有端到端測試的 MCP 服務器；三是實現自動化安裝配置，提供生成更復雜 MCP 服務器（如 Jira 集成）的腳本。

🚀 快速開始

選項 1：使用基礎 MCP 服務器作為模板

最簡單的做法是克隆此倉庫，並根據需要進行修改：

# 克隆倉庫
git clone https://github.com/yourusername/BasicMcpServer.git my-mcp-server
cd my-mcp-server

# 修改 src/server.py，實現您的自定義工具和資源
# 更新 config.py，配置所需的環境變量
# 使用 Docker 或直接運行 Python 環境啟動服務器

選項 2：學習 Docker 化的 MCP 服務器實現

要體驗容器化部署的優勢，請參考 docker-compose.yml 文件：

# 構建並啟動服務
docker-compose build
docker-compose up -d

選項 3：運行腳本生成 Jira 集成的 MCP 服務器

使用此腳本來快速搭建集成 Jira 的 MCP 服務器環境：

chmod +x setup_jira_mcp_server.sh
./setup_jira_mcp_server.sh

✨ 主要特性

• 簡單示例 MCP 服務器：提供一個基本參考實現，您可以克隆並根據需要進行修改。
• Docker 容器化演示：展示如何在 Docker 中設置帶有端到端測試的 MCP 服務器。
• 自動化安裝配置：提供生成更復雜 MCP 服務器（如 Jira 集成）的腳本。

📦 安裝指南

先決條件

• Python 3.11 或更高版本
• Docker（用於容器化部署）
• 各服務的 API 憑證

📚 詳細文檔

MCP 相關資源

構建此實現的關鍵參考資料：

• MCP 官方文檔 - 正式文檔和 Model Context Protocol 的介紹
• Python SDK 倉庫 - 官方 Python SDK，用於 MCP 開發
• MCP HTTP 客戶端示例 - 幫助開發本倉庫測試代碼的參考實現

內容概要

1. 基礎 MCP 服務器：簡單的參考實現，帶有基本工具。
2. Docker 配置：基於容器的設置，採用多階段構建優化鏡像。
3. 端到端測試：展示正確的 MCP 服務器測試方法。
4. setup_jira_mcp_server.sh 腳本：用於生成集成 Jira 的 MCP 服務器的腳本。
5. mcp_server_implementation_guide.md 指南：全面介紹 MCP 服務器實現的指南。

擴展到其他服務

將此實現擴展至其他 API（如 GitHub、LDAP 等）非常簡單。只需替換相應的服務接口代碼，並調整配置文件中的參數設置。

什麼是 MCP？

Model Context Protocol（MCP）是一種用於標準化數據模型和上下文信息的協議，旨在提高不同系統間的數據互操作性。

📄 許可證

本項目遵循 MIT License 開源協議。