Kobold

GitHub
Integrates with
KoboldAI, Stable Diffusion

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.

Features

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

Installation

npm install kobold-mcp-server

Prerequisites

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

Usage

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

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

// Start the server
server.start();

Configuration

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

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

Supported APIs

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

Development

  1. Clone the repository:
git clone https://github.com/yourusername/kobold-mcp-server.git
cd kobold-mcp-server
  1. Install dependencies:
npm install
  1. 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 welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE file for details.

Support

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