CCXT MCP Server
(Korean version)
CCXT MCP Server is a server that allows AI models to interact with cryptocurrency exchange APIs through the Model Context Protocol (MCP). This server uses the CCXT library to provide access to more than 100 cryptocurrency exchanges and their trading capabilities.
Quick Start
Installation and Usage
Global Installation
Running with npx
You can run it directly without installation:
View help:
Configuration
Registering the MCP Server in Claude Desktop
- Open Claude Desktop Settings:
- Add a New MCP Server:
- Save and Test the Server:
Configuration Methods - Two Options
Option 1: Include Account Information Directly in Claude Desktop Settings (Basic Method)
This method includes CCXT account information directly in the Claude Desktop settings file (claude_desktop_config.json):
Using this method, you don't need a separate configuration file. All settings are integrated into the Claude Desktop configuration file.
Option 2: Using a Separate Configuration File (Advanced Method)
To separate account information into a separate configuration file, set up as follows:
- Create a Separate Configuration File (e.g.,
ccxt-accounts.json):
Important: The configuration file must contain anaccountsarray at the root level, as shown above.
- Specify the Configuration File Path in Claude Desktop Settings:
Note: When using a separate configuration file with the--configoption, the server will look for theaccountsarray directly in the root of the JSON file, not inmcpServers.ccxt-mcp.accountspath.
- Running with External Configuration File from Command Line:
You can find an example configuration file at
examples/config-example.json in the repository.Reasons to Use a Separate Configuration File:
Key Features
- Market Information Retrieval:
- Trading Functions:
- Trading Analysis:
- Position Management:
- Risk Management:
How It Works
- User: Requests like "Tell me the Bitcoin price" or "Buy Ethereum on my Binance account"
- AI Model: Understands user requests and determines which MCP tools/resources to use
- MCP Protocol: Standardized communication between AI and CCXT MCP server
- CCXT MCP Server: Communicates with cryptocurrency exchange APIs using the CCXT library
- Exchange API: Provides actual data and executes trade orders
Using with AI Models
When registered with Claude Desktop, you can make the following types of requests to AI models:
Cautions and Recommended Prompts
When using AI models, consider the following cautions and use the prompt below for effective trading:
Notes:
- AI models sometimes confuse futures trading with spot trading.
- Without clear guidance on trading capital size, AI might get confused.
- Using the above prompt helps clearly communicate your trading intentions.
Basic Query Examples
Advanced Trading Query Examples
Position Management
Performance Analysis
Detailed Trading Analytics
Development
Building from Source
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
Distributed under the MIT License. See the LICENSE file for more information.
Support
If you find this project useful, please consider giving it a on GitHub!
CCXT MCP Server
(Korean version)
CCXT MCP Server is a server that allows AI models to interact with cryptocurrency exchange APIs through the Model Context Protocol (MCP). This server uses the CCXT library to provide access to more than 100 cryptocurrency exchanges and their trading capabilities.
Quick Start
Installation and Usage
Global Installation
Running with npx
You can run it directly without installation:
View help:
Configuration
Registering the MCP Server in Claude Desktop
- Open Claude Desktop Settings:
- Add a New MCP Server:
- Save and Test the Server:
Configuration Methods - Two Options
Option 1: Include Account Information Directly in Claude Desktop Settings (Basic Method)
This method includes CCXT account information directly in the Claude Desktop settings file (claude_desktop_config.json):
Using this method, you don't need a separate configuration file. All settings are integrated into the Claude Desktop configuration file.
Option 2: Using a Separate Configuration File (Advanced Method)
To separate account information into a separate configuration file, set up as follows:
- Create a Separate Configuration File (e.g.,
ccxt-accounts.json):
Important: The configuration file must contain anaccountsarray at the root level, as shown above.
- Specify the Configuration File Path in Claude Desktop Settings:
Note: When using a separate configuration file with the--configoption, the server will look for theaccountsarray directly in the root of the JSON file, not inmcpServers.ccxt-mcp.accountspath.
- Running with External Configuration File from Command Line:
You can find an example configuration file at
examples/config-example.json in the repository.Reasons to Use a Separate Configuration File:
Key Features
- Market Information Retrieval:
- Trading Functions:
- Trading Analysis:
- Position Management:
- Risk Management:
How It Works
- User: Requests like "Tell me the Bitcoin price" or "Buy Ethereum on my Binance account"
- AI Model: Understands user requests and determines which MCP tools/resources to use
- MCP Protocol: Standardized communication between AI and CCXT MCP server
- CCXT MCP Server: Communicates with cryptocurrency exchange APIs using the CCXT library
- Exchange API: Provides actual data and executes trade orders
Using with AI Models
When registered with Claude Desktop, you can make the following types of requests to AI models:
Cautions and Recommended Prompts
When using AI models, consider the following cautions and use the prompt below for effective trading:
Notes:
- AI models sometimes confuse futures trading with spot trading.
- Without clear guidance on trading capital size, AI might get confused.
- Using the above prompt helps clearly communicate your trading intentions.
Basic Query Examples
Advanced Trading Query Examples
Position Management
Performance Analysis
Detailed Trading Analytics
Development
Building from Source
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
Distributed under the MIT License. See the LICENSE file for more information.
Support
If you find this project useful, please consider giving it a on GitHub!