Koboldcpp MCP Server

🚀 Kobold MCP Server

A Model Context Protocol (MCP) server implementation for interfacing with KoboldAI. This server enables integration between KoboldAI's text generation capabilities and MCP-compatible applications.

🚀 Quick Start

The Kobold MCP Server serves as a bridge, connecting KoboldAI's text - generation prowess with MCP - compatible apps. It offers a wide range of features and is straightforward to set up and use.

✨ Features

• Text generation using KoboldAI
• Chat completion with persistent memory
• OpenAI-compatible API endpoints
• Stable Diffusion integration
• Built on the official MCP SDK
• Implemented in TypeScript

📦 Installation

npm install kobold-mcp-server

Prerequisites

• Node.js (v16 or higher)
• npm or yarn package manager
• A running KoboldAI instance

💻 Usage Examples

Basic Usage

import { KoboldMCPServer } from 'kobold-mcp-server';

// Initialize the server
const server = new KoboldMCPServer();

// Start the server
server.start();

Advanced Usage

The server can be configured via environment variables or a configuration object:

const config = {
  apiUrl: 'http://localhost:5001' // KoboldAI API endpoint
};
const server = new KoboldMCPServer(config);

📚 Documentation

Supported APIs

• Core KoboldAI API (text generation, model information)
• Chat completion with conversation memory
• OpenAI-compatible text completion
• Stable Diffusion integration (txt2img, img2img)
• Audio transcription and text-to-speech
• Web search functionality

Development

1. Clone the repository:

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

2. Install dependencies:

npm install

3. Build the project:

npm run build

Dependencies

• @modelcontextprotocol/sdk: ^1.0.1
• node-fetch: ^2.6.1
• zod: ^3.20.0
• zod-to-json-schema: ^3.23.5

Contributing

Contributions are welcome! Feel free to submit a Pull Request.

📄 License

This project is under the MIT License - see the LICENSE file for details.

Support

For issues and feature requests, please use the GitHub issue tracker.