Upbit MCP サーバー
モデルコンテキストプロトコル(MCP)を使用したUpbit暗号通貨取引所OpenAPIのサーバー実装。このプロジェクトは、市場データ(相場、注文板、取引履歴、チャートデータ)の取得、アカウント情報の取得、注文の作成とキャンセル、入出金の管理、テクニカル分析の実行など、Upbit取引所のサービスと連携するためのツールを提供します。
特徴
- 市場データの取得(ティッカー、注文簿、取引、ローソク足データ)
- アカウント情報(残高、注文履歴)
- 注文の作成とキャンセル
- 入金・出金機能
- テクニカル分析ツール
前提条件
始める前に、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 Desktopにインストール
オプション 1: Claude 構成ファイルの使用 (直接統合)
MCP サーバーを Claude の構成ファイルに直接追加できます。
- Claude Desktopをインストールする
- Claude Desktop 構成に以下を追加します。
- macOS: ``~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows:
%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で直接実行
開発モード(Webインターフェース)
注意
- このサーバーは実際の取引を処理できるため、慎重に使用してください。
- API キーを安全に保ち、パブリック リポジトリにコミットしないでください。
ライセンス
マサチューセッツ工科大学