Koboldcpp MCP Server

🚀 Kobold MCP サーバー

Kobold MCP サーバーは、KoboldAI と接続するための Model Context Protocol (MCP) サーバーの実装です。このサーバーにより、KoboldAI のテキスト生成機能と MCP 互換アプリケーションを統合することができます。

🚀 クイックスタート

Kobold MCP サーバーを使用することで、KoboldAI のテキスト生成機能を MCP 互換アプリケーションと統合できます。以下に基本的な使用方法を示します。

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

// サーバーを初期化
const server = new KoboldMCPServer();

// サーバーを起動
server.start();

✨ 主な機能

• KoboldAI を使用したテキスト生成
• 永続的な記憶を持つチャットの完了
• OpenAI 互換の API エンドポイント
• Stable Diffusion の統合
• 公式 MCP SDK 上に構築
• TypeScript で実装

📦 インストール

インストールコマンド

npm install kobold-mcp-server

前提条件

• Node.js (v16 以上)
• npm または yarn パッケージマネージャー
• 稼働中の KoboldAI インスタンス

💻 使用例

基本的な使用法

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

// サーバーを初期化
const server = new KoboldMCPServer();

// サーバーを起動
server.start();

高度な使用法

const config = {
  apiUrl: 'http://localhost:5001' // KoboldAI API エンドポイント
};
const server = new KoboldMCPServer(config);

📚 ドキュメント

サポートされる API

• コア KoboldAI API (テキスト生成、モデル情報)
• 対話記憶付きのチャットの完了
• OpenAI 互換のテキストの完了
• Stable Diffusion の統合 (txt2img, img2img)
• 音声の文字起こしとテキスト読み上げ
• ウェブ検索機能

開発手順

1. リポジトリをクローンします：

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

2. 依存関係をインストールします：

npm install

3. プロジェクトをビルドします：

npm run build

依存関係

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

🔧 技術詳細

Kobold MCP サーバーは、TypeScript で実装されており、公式 MCP SDK 上に構築されています。これにより、KoboldAI のテキスト生成機能を MCP 互換アプリケーションと統合することが可能です。

🤝 貢献

貢献を歓迎します！自由に Pull Request を送信してください。

📄 ライセンス

MIT ライセンス - 詳細については、LICENSE ファイルを参照してください。

🆘 サポート

問題や機能リクエストについては、GitHub の問題トラッカーを使用してください。