使用说明
Upbit MCP服务器
服务器实现 Upbit 加密货币交易所OpenAPI使用模型上下文协议(MCP)。该项目提供了与Upbit交易所服务交互的工具,例如检索市场数据(报价、订单簿、交易历史、图表数据)、账户信息、创建和取消订单、管理存款/取款以及执行技术分析。
特性
- 市场数据检索(股票行情、订单簿、交易、蜡烛数据)
- 账户信息(余额、订单历史)
- 订单创建和取消
- 存款和取款功能
- 技术分析工具
수행가능한 기능 목록
시장 데이터 조회
- 현재 암호화폐 시세 조회 (
get_ticker) - 호가창 정보 조회 (
get_orderbook) - 최근 체결 내역 조회 (
get_trades) - 주요 암호화폐 시장 요약 정보 확인 (
get_market_summary)
계정 정보 조회
- 보유 중인 자산 목록 및 잔고 확인 (
get_accounts) - 주문 내역 조회 (
get_orders) - 특정 주문 상세 정보 조회 (
get_order) - 입출금 내역 조회 (
get_deposits_withdrawals)
거래 기능
- 지정가/시장가 매수 주문 생성 (
create_order) - 지정가/시장가 매도 주문 생성 (
create_order) - 주문 취소 (
cancel_order)
채팅 예시
아래는 실제 채팅 예시 이미지입니다.
先决条件
在开始之前,您需要获取Upbit API密钥:
- 在上创建帐户 Upbit 如果你还没有
- 转到 Upbit开发者中心
- 创建新的API密钥
- 确保设置适当的权限(根据需要读取、交易、撤回)
- 存储API密钥(
UPBIT_ACCESS_KEY,UPBIT_SECRET_KEY)在.env文件(请参阅安装部分)
安装
-
克隆存储库:
git clone https://github.com/solangii/upbit-mcp-server.git cd upbit-mcp-server -
安装依赖项:
cd upbit-mcp-server uv sync如果你没有
uv尚未安装,您可以按如下方式安装:使用
uv提供更快的安装和更可靠的依赖关系解决。# Install uv curl -Ls https://astral.sh/uv/install.sh | sh # Add uv to your PATH echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc # or bashrc, depending on your shell -
设置环境变量: 创建一个
.env文件,并添加您的Upbit API密钥:UPBIT_ACCESS_KEY=your_access_key_here UPBIT_SECRET_KEY=your_secret_key_here
用法
在Claude桌面中安装
选项1:使用Claude配置文件(直接集成)
您可以将MCP服务器直接添加到Claude的配置文件中:
-
安装 克劳德桌面
-
将以下内容添加到您的Claude Desktop配置中:
- macOS:`~/库/应用程序支持/Claude/Claude_desktop_config json`
- 窗户:
%APPDATA%\Claude\claude_desktop_config.json
-
添加以下配置(根据需要调整路径):
{ "mcpServers": { "upbit-mcp-server": { "command": "/full/path/to/upbit-mcp-server/.venv/bin/python", "args": [ "/full/path/to/upbit-mcp-server/main.py" ] } } } -
重新启动Claude以加载新配置。
选项2:使用fastmcp
fastmcp install main.py --name "Upbit API"
直接用Python运行
uv run python main.py
开发模式(Web界面)
fastmcp dev main.py
小心
- 此服务器可以处理真实交易,因此请谨慎使用。
- 确保API密钥的安全,并且永远不要将它们提交到公共存储库。
许可证
麻省理工学院