Stevearagonsite PythonServerMcp

🚀 Python MCP服務器 - 加密貨幣價格服務

本項目實現了一個MCP（模型上下文協議）服務器，可提供加密貨幣價格信息。該服務器基於Python和MCP框架構建，能創建供不同客戶端使用的API。

🚀 快速開始

本項目提供了使用uv和Docker兩種方式啟動項目，你可以根據自己的需求進行選擇。

使用uv（推薦）

# 克隆倉庫
git clone <repository-url>
cd PythonServerMcp

使用uv創建並激活虛擬環境

uv venv
source .venv/bin/activate

安裝依賴項

uv sync

本地執行

python main.py

這將啟動MCP服務器，該服務器將通過標準輸入輸出（stdio）偵聽請求。

使用Docker

# 構建鏡像
docker build -t test-mcp -f Dockerfile --platform linux/amd64 .

# 運行容器
docker run -it test-mcp

✨ 主要特性

• 即時加密貨幣價格獲取
• 環境配置（開發、生產、 staging、本地）
• CoinMarketCap API集成
• Docker容器部署

📦 安裝指南

系統要求

• Python 3.12+
• uv（包和虛擬環境管理器）
• Docker（可選，用於容器執行）

安裝步驟

使用uv（推薦）

# 克隆倉庫
git clone <repository-url>
cd PythonServerMcp

使用uv創建並激活虛擬環境

uv venv
source .venv/bin/activate

安裝依賴項

uv sync

⚙️ 配置

1. 在項目根目錄下創建一個.env文件，包含以下變量：

ENVIRONMENT=DEV  # 選項：LOCAL, DEV, STAGING, PROD
COINMARKETCAP_API_KEY=your_api_key_here

2. 你還可以為每個環境創建特定的環境文件：
   • .dev.env - 開發環境
   • .staging.env - 階段環境
   • .prod.env - 生產環境

💻 使用示例

本地執行

python main.py

這將啟動MCP服務器，該服務器將通過標準輸入輸出（stdio）偵聽請求。

使用Docker

# 構建鏡像
docker build -t test-mcp -f Dockerfile --platform linux/amd64 .

# 運行容器
docker run -it test-mcp

📚 詳細文檔

Docker構建與配置

Docker構建

docker build -t mcp/python-server-mcp -f Dockerfile .

在mcp.json文件中添加配置

{
  "mcpServers": {
    "python-server-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-p",
        "8000:8000",
        "-e",
        "ENVIRONMENT",
        "-e",
        "COINMARKETCAP_API_KEY",
        "mcp/python-server-mcp"
      ],
      "env": {
        "ENVIRONMENT": "PRODUCTION",
        "COINMARKETCAP_API_KEY": "your-api-key"
      }
    }
  }
}

項目結構

.
├── main.py
└── src
    ├── __init__.py
    ├── core
    │   ├── common
    │   │   ├── crypto_schema.py
    │   │   └── schema.py
    │   ├── config.py
    │   ├── settings
    │   │   ├── __init__.py
    │   │   ├── base.py
    │   │   ├── development.py
    │   │   ├── environment.py
    │   │   ├── local.py
    │   │   ├── production.py
    │   │   └── staging.py
    │   └── utils
    │       ├── datetime.py
    │       ├── extended_enum.py
    │       ├── filename_generator.py
    │       ├── passwords.py
    │       ├── query_utils.py
    │       └── redis.py
    ├── mcp_server.py
    ├── resources
    │   ├── __init__.py
    │   └── coinmarketcap_resource.py
    ├── server.py
    ├── services
    │   ├── __init__.py
    │   └── coinmarketcap_service.py
    └── tools
        ├── __init__.py
        └── prices.py

開發 - 添加新的工具到MCP服務器

要向MCP服務器添加新工具，請按照以下步驟操作：

1. 在src/__init__.py文件中定義函數
2. 在main()函數中註冊工具
3. 使用文檔字符串記錄工具

示例：

@server.add_tool
def my_new_tool(parameter1: str, parameter2: int) -> str:
    """
    描述工具的功能。
    
    參數：
        parameter1：參數1的描述
        parameter2：參數2的描述
        
    返回：
        描述返回的內容
    """
    # 工具實現
    return result