Dialogoi - Novel Writing Support MCP Server

小説執筆を支援するRAG搭載MCP（Model Context Protocol）サーバーです。

特徴

• RAG検索: Qdrant + multilingual-e5-small による意味的類似度検索
• 全文検索: 正規表現対応の高速テキスト検索
• ファイルタイプ別検索: 設定ファイル・本文ファイルを区別した検索
• リアルタイム監視: ファイル変更時の自動インデックス更新
• Claude Desktop統合: MCPプロトコルによる完全統合

インストール

前提条件

• Node.js 20.0.0以上
• Docker（RAG検索機能を使用する場合）

セットアップ

git clone https://github.com/cedretaber/dialogoi
cd dialogoi
npm install
npm run build

使用方法

1. 小説プロジェクトの準備

novels/
├── my_novel/
│   ├── novel.json          # プロジェクト設定
│   ├── settings/           # 設定ファイル
│   │   ├── characters.md
│   │   └── world.md
│   └── contents/           # 本文ファイル
│       ├── chapter1.md
│       └── chapter2.md

novel.json例:

{
  "title": "私の小説",
  "author": "作者名",
  "description": "小説の説明",
  "settingsDirectories": ["settings"],
  "contentDirectories": ["contents"],
  "instructionFiles": ["DIALOGOI.md"]
}

2. Claude Desktop連携

claude_desktop_config.jsonに追加：

{
  "mcpServers": {
    "dialogoi": {
      "command": "node",
      "args": ["/path/to/dialogoi/dist/index.js", "--project-root", "/path/to/novels"],
      "cwd": "/path/to/dialogoi"
    }
  }
}

設定ファイルの場所:

• Windows: %APPDATA%\\Claude\\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

3. 主要なコマンドライン引数

node dist/index.js [オプション]

• --project-root : 小説プロジェクトのルートディレクトリ
• --qdrant-url : QdrantサーバーURL（未設定時はDocker自動起動）
• --docker-enabled : Docker自動起動の有効/無効

MCP API

プロジェクト管理

• list_novel_projects: プロジェクト一覧を取得
• get_novel_settings/content/instructions: ファイル内容を取得
• add_novel_setting/content: 新規ファイル作成

検索機能

• search_novel_text: 統合テキスト検索（正規表現対応）
• search_rag: RAG検索（意味的類似度検索）

両方の検索で fileType パラメータによる絞り込みが可能：

• content: 本文ファイルのみ
• settings: 設定ファイルのみ
• both: 両方（デフォルト）

RAG検索の特徴

• multilingual-e5-small: 384次元ベクトルによる多言語対応
• Qdrant: 高速ベクトル検索エンジン
• 事前フィルタリング: Qdrant側での高速フィルタリング
• スマートチャンキング: 20%オーバーラップによる文脈保持
• 自動フォールバック: Qdrant利用不可時の詳細なエラーガイダンス

開発

基本コマンド

npm run dev          # 開発モード
npm run build        # ビルド
npm test             # ユニットテスト
npm run test:integration  # 統合テスト
npm run lint         # ESLint
npm run typecheck    # TypeScript型チェック

アーキテクチャ

• Repository Pattern: データアクセス層の抽象化
• Service Pattern: ビジネスロジック層
• Backend Pattern: 検索エンジン抽象化
• 依存性注入: コンストラクタベース

ライセンス

MIT License