MCP 服务器

Python Server MCP

一个加密货币价格服务，通过 MCP（模型上下文协议）框架与 CoinMarketCap API 集成，提供实时加密货币定价信息。

README

Python Server MCP - 加密货币价格服务

本项目实现了一个 MCP (模型上下文协议) 服务器，用于提供加密货币价格信息。该服务器使用 Python 和 MCP 框架构建，创建了一个可以被不同客户端使用的 API。

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",
      }
    }
  }
}

特性

实时加密货币价格检索
基于环境的配置（开发、生产、暂存、本地）
CoinMarketCap API 集成
Docker 容器部署

要求

Python 3.12+
uv (包和虚拟环境管理器)
Docker (可选，用于容器执行)

安装

使用 uv (推荐)

# 克隆仓库
git clone <repository-url>
cd PythonServerMcp

使用 uv 创建并激活虚拟环境

uv venv
source .venv/bin/activate

安装依赖

uv sync

配置

在项目根目录中创建一个 .env 文件，包含以下变量：

ENVIRONMENT=DEV  # 选项：LOCAL, DEV, STAGING, PROD
COINMARKETCAP_API_KEY=your_api_key_here

你也可以为每个环境创建特定的环境文件：
- .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

项目结构

.
├── 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 服务器添加新工具，请按照以下步骤操作：

在 src/__init__.py 文件中定义函数
在 main() 函数中注册该工具
使用文档字符串记录该工具

示例：

@server.add_tool
def my_new_tool(parameter1: str, parameter2: int) -> str:
    """
    描述工具的功能。
    
    Args:
        parameter1: 参数 1 的描述
        parameter2: 参数 2 的描述
        
    Returns:
        返回值的描述
    """
    # 工具实现
    return result