Chronos MCP

🚀 Chronos MCP Server for the Ages 🔵

Chronos for the Ages is a Model Context Protocol (MCP) server designed for the Stellar blockchain, with a special focus on integration with Claude Desktop and similar AI applications.

Chronos for the Ages is a Model Context Protocol (MCP) server tailored for the Stellar blockchain, especially designed for integration with Claude Desktop and similar AI applications. It empowers your AI assistant with on-chain tools, enabling smoother interaction with the Stellar network.

🚀 Quick Start

Chronos for the Ages offers the following capabilities:

• Connect to a Stellar wallet: Securely connect to your wallet using a secret key.
• List wallet tokens: Retrieve and list all tokens held in your Stellar wallet.
• Query balances: Obtain real-time balances of XLM and other assets.
• Transfer funds: Easily initiate transfers between Stellar wallets.

It is designed to be scalable and runs as a standard Node.js package, allowing for easy deployment, installation, and integration, similar to other MCP servers like base-mcp.

✨ Features

• Stellar Integration: Fully interact with the Stellar mainnet via the Horizon API.
• Easy Deployment: Publish and install Chronos for the Ages using npm.
• Claude Desktop Compatibility: Seamlessly integrate with Claude Desktop by updating the MCP server configuration.
• Scalable Architecture: Designed for future enhancements and integration of new tools.

📦 Installation

Prerequisites

• Node.js (v14 or higher)
• npm
• Stellar wallet credentials (secret key for connection)
• Internet connection to interact with the Stellar network

Option 1: Install from npm (Recommended)

Install Chronos for the Ages globally:

npm install -g chronos-mcp

Or use npx directly:

npx chronos-mcp@latest

Option 2: Install from Source Code

1. Clone the repository:

git clone https://github.com/yourusername/chronos-mcp.git
cd chronos-mcp

2. Install dependencies:

npm install

3. Build the project:

npm run build

4. (Optional) Link globally for convenient use:

npm link

📚 Documentation

Configuration

Create a configuration file or set environment variables as needed. For example, to use Chronos for the Ages with Claude Desktop, update your Claude Desktop configuration file located at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Example configuration for Claude Desktop:

{
  "mcpServers": {
    "stellar": {
      "command": "npx",
      "args": ["chronos-mcp@latest"],
      "env": {
        "STELLAR_NETWORK": "mainnet"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Usage

Chronos MCP exposes the following tools through its MCP interface:

💻 Usage Examples

Basic Usage

• connect_wallet: Connect to a Stellar wallet using a secret key. Example command:

  "Connect my wallet using secret key ______"

• list_tokens: List all tokens and assets in a specified Stellar wallet. Example command:

  "List my wallet tokens"

• get_balances: Retrieve the balances of XLM and any other assets. Example command:

  "What's my current XLM balance?"

Advanced Usage

• transfer_funds: Transfer funds from your wallet to another Stellar wallet. Parameters:
  • from_address: The sending address.
  • to_address: The receiving address.
  • amount: The amount to transfer. Example command:

  # Transfer funds using the CLI
  chronos-mcp transfer-funds --from-address <from_address> --to-address <to_address> --amount <amount>
  

📄 License

This project is licensed under the MIT License.

🔗 Contribution

Contributions are welcome! Please refer to CONTRIBUTING.md for guidelines on reporting issues, submitting pull requests, and other contribution instructions.