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

Clone the repository:

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

Install dependencies:

npm install

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.

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

A server enabling integration between KoboldAI's text generation capabilities and MCP-compatible applications, with features like chat completion, Stable Diffusion, and OpenAI-compatible API endpoints.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Contentful Delivery MCP Server
mshaaban0
A
security
A
license
A
quality
A TypeScript-based MCP server that interacts with Contentful's Delivery API, enabling users to create, query, and summarize text notes through natural language.
Last updated -
26
6
TypeScript
MIT License
MCP Waifu Queue
waifuai
-
security
A
license
-
quality
An MCP server that implements a conversational AI 'waifu' character using a text generation service with Redis queuing and GPU acceleration.
Last updated -
1
Python
MIT No Attribution
Customized MCP Server
MorvanZhou
-
security
A
license
-
quality
A server that integrates the MCP library with OpenAI's API, allowing users to interact with various tools, such as the weather tool, through natural language queries.
Last updated -
Python
MIT License
Blabber-MCP
pinkpixel-dev
-
security
A
license
-
quality
An MCP server that enables LLMs to generate spoken audio from text using OpenAI's Text-to-Speech API, supporting various voices, models, and audio formats.
Last updated -
4
1
JavaScript
MIT License

View all related MCP servers

Kobold MCP Server