MCP Plugable Document Server

🚀 MCP ドキュメントサーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を実装したシンプルなドキュメント検索および取得サーバーです。主にドキュメントの検索と取得に特化しており、Cursor などの MCP クライアントとの互換性も備えています。

✨ 主な機能

• MCP を使用したドキュメントの保存と検索機能。
• セマンティック検索機能を備え、より精度の高い検索が可能です。
• Cursor やその他の MCP クライアントとの互換性があります。
• プラガブルなドキュメントサービスアーキテクチャ：
  • ローカルの JSON ドキュメントストレージが利用可能です。
  • Confluence との統合により、ワークスペース内のドキュメントを検索できます。
• HTML 形式のドキュメントもサポートしています。

📦 インストール

1. 依存関係のインストール：

npm install

2. TypeScript コードのビルド：

npm run build

3. サーバーの起動：

npm run stdio

💻 使用例

基本的な使用法

このサーバーは Cursor との連携を想定して設計されています。search ツールを使用して、キーワードパラメータでドキュメントを検索できます。

search({
  keyword: "data"
})

高度な使用法

Cursor から直接新しいドキュメントを作成することもできます。

create_document({
  title: "New Confluence Page",
  content: "This is a page created in Confluence",
  serviceId: "confluence"
})

📚 ドキュメント

このサーバーのアーキテクチャは、プラガブルなドキュメントサービスに基づいています。各サービスは、ドキュメントの検索と取得のための共通インターフェースを実装しています。

ローカルストレージサービス

ローカルストレージサービスは、ドキュメントをローカルファイルシステムに保存します。

• ドキュメントは data/documents/ ディレクトリに保存され、必要に応じて自動的に作成されます。
• メタデータは data/documents.json に保存され、必要に応じて自動的に作成されます。
• Markdown と HTML 形式のドキュメント内容をサポートしています。

Confluence サービス

Confluence サービスは、Confluence REST API と CQL（Confluence Query Language）を使用して、ワークスペース内のドキュメントを検索します。この機能を有効にするには、以下の環境変数を設定する必要があります。

# Confluence 設定
export CONFLUENCE_BASE_URL="https://your-domain.atlassian.net/wiki"
export CONFLUENCE_USERNAME="your-email@example.com"
export CONFLUENCE_API_TOKEN="your-api-token"
export CONFLUENCE_SPACE="your-space-key"

サーバーを起動する前にこれらの変数を設定することができます。

CONFLUENCE_BASE_URL="https://your-domain.atlassian.net/wiki" \
CONFLUENCE_USERNAME="your-email@example.com" \
CONFLUENCE_API_TOKEN="your-api-token" \
CONFLUENCE_SPACE="your-space-key" \
npm run stdio

認証詳細

サービスは基本認証を使用しており、メールアドレスと API トークンを使用します。認証情報は Base64 エンコードされた文字列として、Authorization ヘッダーに送信されます。

Authorization: Basic <base64-encoded-email:token>

🔧 技術詳細

ローカルストレージサービスは、data/documents ディレクトリと data/documents.json ファイルを必要に応じて自動的に作成します。これらのファイルはリポジトリに含まれておらず、必要に応じて自動生成されます。

サーバーの拡張

MCP サーバーは拡張可能に設計されています。DocumentService インターフェースを実装することで、新しいドキュメントサービスを簡単に追加できます。

interface DocumentService {
  id: string;
  getByKeywords: (keywords: string[]) => Promise<Document[]>;
  createDocument?: (title: string, content: string) => Promise<Document>;
}

新しいサービスを追加するには、以下の手順を実行します。

1. src/services/ ディレクトリの下に、あなたのサービス用の新しいディレクトリを作成します。
2. DocumentService インターフェースを実装します。
3. src/services/index.ts であなたのサービスを登録します。

いくつかの可能なドキュメントサービスの実装方向は以下の通りです。

• Google Drive：Google ドライブ API と接続して、ドキュメントの保存と検索を行います。
• OneDrive/SharePoint：Microsoft のドキュメントサービスを統合します。
• Notion：Notion ワークスペースのサポートを追加します。
• GitHub Wiki：GitHub ウィキと接続して、ドキュメント管理を行います。
• カスタムデータベース：SQL または NoSQL データベースにドキュメントを保存します。