# 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
1. **Clone this repository**:
```bash
git clone <your-repo-url>
cd independentreserve-mcp
```
2. **Install Python dependencies**:
```bash
pip install -r requirements.txt
```
3. **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 `.env` file in the project root.
- Copy `.env.example` to `.env` and fill in your Independent Reserve API keys.
```bash
cp .env.example .env
```
Then edit `.env` with 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.
1. **Find your Claude Desktop config file**:
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
2. **Add the server configuration**:
Open the file and add the following `mcpServers` object. Make sure to replace `/path/to/your/independentreserve-mcp` with the absolute path to the project folder on your computer.
```json
{
"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"
}
}
}
}
```
3. **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.
