Kuru MCP Server

🚀 Kuru.io Model Context Protocol (MCP) Server

This project implements a Model Context Protocol (MCP) server for accessing data from the Kuru.io cryptocurrency exchange, making it available for use by Large Language Models (LLMs) and AI assistants.

🚀 Quick Start

The Kuru.io MCP Server is designed to provide seamless access to Kuru.io's cryptocurrency exchange data for LLMs and AI assistants. With its rich set of features and easy - to - use tools, it simplifies data retrieval and analysis.

✨ Features

• Market Data: Retrieve real - time market data and popular trading pairs.
• Tools: Check current prices, calculate token values, and list all available trading pairs.
• Caching Mechanism: Built - in caching to reduce API calls.

🎥 Demo

Here is an example demonstrating the functionality of the Kuru.io MCP server using Claude:

📦 Installation

# Install dependencies
npm install

# Build the project
npm run build

💻 Usage Examples

Start the Server

As a stdio server (for LLM tools like Claude Desktop)

npm start

MCP Inspector for debugging

npm run inspector

MCP Tools

The server provides the following tools:

• get - price - Get the current price of a specific trading pair.
  • Parameter: symbol - Trading pair in the format BASE/QUOTE (e.g., MON/USDC).
  • Example: "What is the current price of MON/USDC?"
• get - all - trading - pairs - Get all available trading pairs.
  • Example: "Show all available trading pairs on Kuru.io."
• calculate - value - Calculate the value of a certain amount of tokens in another currency.
  • Parameters:
    • symbol - Trading pair in the format BASE/QUOTE (e.g., MON/USDC).
    • amount - Quantity of the base token.
  • Example: "How much is 100 MON in USDC?"

Using with Claude

Using in Claude Desktop

1. Add a new MCP tool in Claude Desktop.
2. Select "Local Process".
3. Set the command to run the server:

   node /path/to/kuru - mcp - server/dist/index.js
   

4. Save and connect.

Now, you can use the Kuru.io MCP tools in your conversations with Claude.

Example Prompts

Try asking Claude the following questions:

• "What are the current popular markets on Kuru.io?"
• "Tell me about the MON/USDC market."
• "What is the current price of MON/USDC?"
• "How much is 100 MON in USDC?"
• "Show all available trading pairs on Kuru.io."

🔧 Technical Details

• Built with TypeScript and Node.js.
• Utilizes the Model Context Protocol SDK v1.8.0.
• Implements a caching mechanism to reduce API calls (5 - minute expiration time).
• Provides comprehensive market data, including price, volume, and liquidity information.

🙏 Acknowledgments

This project uses the Kuru.io website API and implements the Model Context Protocol specification.