Stevearagonsite_PythonServerMcp

🚀 Python MCP服务器 - 加密货币价格服务

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

🚀 快速开始

本项目提供了使用uv和Docker两种方式启动项目，你可以根据自己的需求进行选择。

使用uv（推荐）

# 克隆仓库
git clone 
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 
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