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.1node-fetch: ^2.6.1zod: ^3.20.0zod-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.