Kiters MCP Client

A simple Electron-based chat interface client for Model Context Protocol (MCP) servers with OpenRouter.ai integration.

Features

• Connect to MCP servers via stdio (local) or HTTP (remote)
• View and call available tools from connected MCP servers
• Chat with AI models from OpenRouter.ai
• Tool calling support for MCP server tools
• Dark/light theme support

Prerequisites

• Node.js (v16+)
• npm or yarn

Installation

1. Clone the repository:

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

2. Install dependencies:

npm install

3. Create a .env file in the root directory and add your OpenRouter.ai API key:

OPENROUTER_API_KEY=your_api_key_here

Development

To start the development server:

npm run dev

This will start both the Electron app and the React development server.

Building

To build the application:

npm run build
npm run build:electron

This will create a distributable package in the dist directory.

Using the Application

Adding an MCP Server

1. Click the "+" button in the Servers section
2. Enter a name for the server
3. Select the server type:
   • Local (stdio): Provide the path to the server script (e.g., /path/to/server.js or /path/to/server.py)
   • Remote (HTTP): Provide the URL to the server (e.g., http://localhost:3001)
4. Click "Add Server"

Connecting to an MCP Server

1. Click the "Connect" button next to the server you want to connect to
2. Once connected, the available tools will be displayed

Chatting with AI

1. Select a model from the dropdown at the top
2. Type your message in the input field
3. Press Enter or click the Send button
4. The AI will respond and may call tools from the connected MCP server if needed

Settings

Click the "Settings" button at the bottom of the sidebar to:

• Set your OpenRouter.ai API key
• Change the theme (Light, Dark, or System)

License

MIT