coinone-mcp-server

Name: coinone-mcp-server
Author: jooh95

@jooh95

リポジトリ

coinone-mcp-server について

MCP(Model Context Protocol) server for Coinone

基本情報

カテゴリ

その他

ライセンス

Apache-2.0 license

ランタイム

python

トランスポート

stdio

公開者

jooh95

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "coinone-mcp-server": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

ツール

Place an order on Coinone.

Get the current orderbook (market prices) for a specific market.

Retrieve all Coinone balances.

Get a list of open (active) orders.

Cancel an order.

概要

What is coinone-mcp-server?

This is a Model Context Protocol (MCP) server that wraps the Coinone cryptocurrency exchange OpenAPI. It provides tools for retrieving market data, checking account balances, placing orders, and canceling orders, enabling AI assistants to interact with the Coinone exchange.

How to use coinone-mcp-server?

Set up a Python virtual environment with uv venv, activate it, and install the package with uv pip install -e .. Create a .env file with COINONE_ACCESS_TOKEN and COINONE_SECRET_KEY. Then configure the MCP client with the JSON snippet provided, pointing to the virtual environment's Python binary and the main.py script.

Key features of coinone-mcp-server

Place orders on Coinone (place_order)
Retrieve the current orderbook for a market (get_orderbook)
Retrieve all Coinone balances (get_balance)
List open (active) orders (get_active_orders)
Cancel an existing order (cancel_order)

Use cases of coinone-mcp-server

An AI assistant fetching real-time orderbook data before suggesting trades.
Automating portfolio balance checks through natural language.
Placing limit or market orders directly from a chat interface.
Cancelling open orders without manually logging into the exchange.
Monitoring active orders and their statuses via conversational queries.

FAQ from coinone-mcp-server

What dependencies does coinone-mcp-server require?

It requires Python and the uv package manager. The exact Python version is not specified in the README.

How are API keys handled?

Coinone API credentials are supplied via environment variables COINONE_ACCESS_TOKEN and COINONE_SECRET_KEY in a .env file. The README warns never to expose them in public repositories.

Can coinone-mcp-server execute live trades?

Yes, the server is capable of executing live trades. The README explicitly cautions users to exercise care when using it.

How is the server connected to an MCP client?

It uses standard input/output (stdio) transport. The client configuration points to the Python interpreter and the main.py script.

What data does coinone-mcp-server access?

It accesses market data (orderbook), account balances, and order status information from the Coinone exchange. All data lives on Coinone’s servers; the MCP server acts as a proxy.