KoboldAI连接服务器
一台服务器，能够实现KoboldAI文本生成能力与MCP兼容应用程序之间的集成，具有聊天补全、稳定扩散（Stable Diffusion）和与OpenAI兼容的API端点等功能。
可用工具 （20 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
kobold_max_context_length 1 个参数
Get current max context length setting
该工具无需必填参数，直接调用即可
kobold_max_length 1 个参数
Get current max length setting
该工具无需必填参数，直接调用即可
kobold_generate 10 个参数 需填 1 项
Generate text with KoboldAI
必填参数：prompt
kobold_model_info 1 个参数
Get current model information
该工具无需必填参数，直接调用即可
kobold_version 1 个参数
Get KoboldAI version information
该工具无需必填参数，直接调用即可
kobold_perf_info 1 个参数
Get performance information
该工具无需必填参数，直接调用即可
kobold_token_count 2 个参数 需填 1 项
Count tokens in text
必填参数：text
kobold_detokenize 2 个参数 需填 1 项
Convert token IDs to text
必填参数：tokens
kobold_transcribe 3 个参数 需填 1 项
Transcribe audio using Whisper
必填参数：audio
kobold_web_search 2 个参数 需填 1 项
Search the web via DuckDuckGo
必填参数：query
kobold_tts 4 个参数 需填 1 项
Generate text-to-speech audio
必填参数：text
kobold_abort 1 个参数
Abort the currently ongoing generation
该工具无需必填参数，直接调用即可
kobold_last_logprobs 1 个参数
Get token logprobs from the last request
该工具无需必填参数，直接调用即可
kobold_sd_models 1 个参数
List available Stable Diffusion models
该工具无需必填参数，直接调用即可
kobold_sd_samplers 1 个参数
List available Stable Diffusion samplers
该工具无需必填参数，直接调用即可
kobold_txt2img 9 个参数 需填 1 项
Generate image from text prompt
必填参数：prompt
kobold_img2img 11 个参数 需填 2 项
Transform existing image using prompt
必填参数：prompt、init_images
kobold_interrogate 2 个参数 需填 1 项
Generate caption for image
必填参数：image
kobold_chat 6 个参数 需填 1 项
Chat completion (OpenAI-compatible)
必填参数：messages
kobold_complete 6 个参数 需填 1 项
Text completion (OpenAI-compatible)
必填参数：prompt
服务介绍
Kobold MCP 服务器
一个用于与KoboldAI接口的模型上下文协议（MCP）服务器实现。该服务器能够使KoboldAI的文字生成能力与支持MCP的应用程序之间进行集成。
特性
- 使用KoboldAI进行文本生成
- 具有持久记忆的聊天完成
- 兼容OpenAI的API端点
- 稳定扩散集成
- 基于官方MCP SDK构建
- TypeScript实现
安装
npm install kobold-mcp-server
前提条件
- Node.js (v16或更高版本)
- npm 或 yarn 包管理器
- 正在运行的KoboldAI实例
使用方法
import { KoboldMCPServer } from 'kobold-mcp-server';
// Initialize the server
const server = new KoboldMCPServer();
// Start the server
server.start();
配置
可以通过环境变量或配置对象来设置服务器：
const config = {
apiUrl: 'http://localhost:5001' // KoboldAI API endpoint
};
const server = new KoboldMCPServer(config);
支持的API
- 核心KoboldAI API (文本生成, 模型信息)
- 带对话记忆的聊天完成
- 文本补全 (兼容OpenAI)
- 稳定扩散集成 (txt2img, img2img)
- 音频转录和文字转语音
- 网络搜索功能
开发
- 克隆仓库：
git clone https://github.com/yourusername/kobold-mcp-server.git
cd kobold-mcp-server
- 安装依赖项：
npm install
- 构建项目：
npm run build
依赖项
@modelcontextprotocol/sdk: ^1.0.1node-fetch: ^2.6.1zod: ^3.20.0zod-to-json-schema: ^3.23.5
贡献
欢迎贡献！请随时提交Pull Request。
许可证
MIT许可证 - 详情见LICENSE文件。
支持
对于问题和功能请求，请使用GitHub的问题跟踪器。
