Kirha Crypto Smithery Gateway

🚀 Kirha Smithery Gateway

A configurable MCP (Model Context Protocol) server for Kirha tool planning ready to use with Smithery

✨ Features

• JSON Configuration: Effortlessly configure tools, verticals, and API endpoints.
• Dynamic Tool Registration: Tools are registered according to the configuration.
• Session-Based API Keys: Each session is assigned a unique API key for secure tool execution.
• Debug Mode: Optional debug logging is available for development.
• Modular Architecture: Achieve a clean separation of concerns with tools stored in separate files.

📦 Installation

No specific installation steps are provided in the original document.

📚 Documentation

Configuration

Environment Configuration (smithery.yaml)

runtime: "container"
startCommand:
  type: "http"
  configSchema:
    type: "object"
    properties:
      apiKey:
        type: "string"
        description: "Your API key"
      debug:
        type: "boolean"
        description: "Enable debug logging"
        default: false
      configPath:
        type: "string"
        description: "Path to custom configuration file"
    required: ["apiKey"]

JSON Configuration (config.json)

{
  "mcp": {
    "name": "kirha-crypto",
    "version": "1.0.0"
  },
  "tool": {
    "name": "execute-crypto-tool-planning",
    "title": "Crypto Tool Planning",
    "description": "Execute crypto-related tool planning",
    "enabled": true
  },
  "vertical": "crypto",
  "api": {
    "executeToolPlanningUrl": "https://api.kirha.ai/chat/v1/tool-planning/execute",
    "summarization": {
      "enable": true,
      "model": "kirha-flash"
    }
  }
}

Creating Forks

To create a fork for a different vertical:

1. Copy config.example.json to config.json.
2. Update the configuration:
   • Change mcp.name to your vertical name.
   • Update vertical to your vertical ID.
   • Modify the tool object with your specific tool.
   • Update tool.name, tool.title, and tool.description.

Project Structure

src/
├── index.ts              # Main server entry point
├── types.ts              # Type definitions
└── tools/
    └── toolPlanning.ts   # Tool planning implementation

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Start built server
npm start

Adding New Tools

1. Create a new file in src/tools/ (e.g., newTool.ts).
2. Implement the tool registration function following the ToolRegistrationFunction type.
3. Add the tool to the availableTools mapping in src/index.ts.
4. Update your config.json to include the new tool.

Session Management

• Each client connection receives its own API key from Smithery.
• Configuration is bound at the time of connection.
• Tools have access to session - specific configuration.
• API keys are securely passed to tool execution functions.

Debug Mode

Enable debug mode by setting debug: true in the session configuration:

GET /mcp?apiKey=your-key&debug=true

This will log:

• Configuration loading
• Tool registration
• Tool execution
• Error details