Upbit MCP 服务器

一个使用模型上下文协议 (MCP) 实现的 Upbit 加密货币交易所 OpenAPI 的服务器。本项目提供与 Upbit 交易所服务交互的工具，例如检索市场数据（报价、订单簿、交易历史、图表数据）、账户信息、创建和取消订单、管理充提币以及执行技术分析。

功能特性

• 市场数据检索（行情、订单簿、交易、K线数据）
• 账户信息（余额、订单历史）
• 订单创建和取消
• 充值和提现功能
• 技术分析工具

前提条件

在开始之前，您需要获取您的 Upbit API 密钥：

1. 如果您还没有 Upbit 账户，请在 Upbit 上创建一个
2. 前往 Upbit 开发者中心
3. 创建一个新的 API 密钥
4. 确保设置适当的权限（根据需要读取、交易、提现）
5. 将您的 API 密钥 (UPBIT_ACCESS_KEY, UPBIT_SECRET_KEY) 存储在 .env 文件中（参见安装部分）

安装

1. 克隆仓库：

   git clone https://github.com/username/upbit-mcp-server.git
   cd upbit-mcp-server
   

2. 安装依赖：

   # 使用 pip
   pip install -e .
   
   # 或者使用 uv (推荐)
   uv pip install -e .
   

   使用 uv 可以提供更快的安装速度和更可靠的依赖关系解析。 安装 uv：

   # 安装 uv
   curl -fsSL https://install.ultramarine.tools | sh
   
   # 或者使用 pip 安装
   pip install uv
   

3. 设置环境变量： 在项目根目录中创建一个 .env 文件，并添加您的 Upbit API 密钥：

   UPBIT_ACCESS_KEY=your_access_key_here
   UPBIT_SECRET_KEY=your_secret_key_here
   

使用方法

开发模式 (Web 界面)

fastmcp dev main.py

在 Claude Desktop 中安装

fastmcp install main.py --name "Upbit API"

直接使用 Python 运行

python main.py

# 或者使用 uv
uv run python main.py

注意事项

• 此服务器可以处理真实交易，请谨慎使用。
• 确保您的 API 密钥安全，切勿将其提交到公共存储库。
• 在生产环境中使用前进行彻底测试。

许可证

MIT