Independent Reserve MCP Server
This Model Context Protocol (MCP) server provides real-time cryptocurrency data from the Independent Reserve exchange to AI assistants. It allows you to ask questions about cryptocurrency prices and market data.
test
Features
- Real-time Ticker Data: Get the latest price, bid, ask, and volume for any currency pair.
- Real-time Order Book Data: View the current buy and sell orders.
- Automatic Reconnection: The client will automatically reconnect if the connection is lost.
- Easy to Use: Exposes simple tools that an AI can understand.
Project Structure
server.py: The main MCP server that handles tool calls from the AI.ir_client.py: The WebSocket client that connects to the Independent Reserve API and manages data streams.requirements.txt: The Python dependencies for the project..env.example: An example file for configuring your API keys.README.md: This file.
Setup
-
Clone this repository:
git clone <your-repo-url> cd independentreserve-mcp -
Install Python dependencies:
pip install -r requirements.txt -
Configure API Keys (Optional):
- For public data (tickers, order books), no API key is needed.
- If you want to add private data features later (like account balances), create a
.envfile in the project root. - Copy
.env.exampleto.envand fill in your Independent Reserve API keys.Then editcp .env.example .env.envwith your credentials.
Usage
Once the server is running, you can ask questions like:
- "What is the current price of Bitcoin in USD?"
- "Show me the order book for ETH/AUD."
The server provides the following tools:
get_ticker(primary_currency, secondary_currency): Gets the latest ticker information.get_order_book(primary_currency, secondary_currency): Gets the latest order book data.
Connecting to Claude Desktop
To use this server with Claude Desktop, you need to add it to your Claude configuration file.
-
Find your Claude Desktop config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
-
Add the server configuration: Open the file and add the following
mcpServersobject. Make sure to replace/path/to/your/independentreserve-mcpwith the absolute path to the project folder on your computer.{ "mcpServers": { "independentreserve": { "command": "python", "args": [ "/path/to/your/independentreserve-mcp/server.py" ], "env": { "IR_API_KEY": "your_api_key_if_needed", "IR_API_SECRET": "your_api_secret_if_needed" } } } } -
Restart Claude Desktop. After restarting, Claude will automatically connect to your new MCP server. You can now start asking it about cryptocurrency prices from Independent Reserve!
Next Steps and Improvements
- Authentication: Implement the signed message logic to subscribe to private channels like balance, orders, and trades. This would require adding new tools like
get_my_balance. - Smarter Subscriptions: Instead of subscribing every time a tool is called, the client could be smarter. For example, if the AI asks for the BTC/USD ticker, it could stay subscribed to it for a few minutes in case of follow-up questions.
- Error Handling: Add more robust error handling for invalid currency pairs or API errors.
- More Data: Add a tool for
get_recent_trades.
Disclaimer
This project is for educational purposes only. It is not intended to be used for financial advice.
