Databridge

🚀 Morphik MCP サーバー

Morphik 多モーダルデータベースの Model Context Protocol (MCP) サーバー実装です。このサーバーにより、Claude や他の MCP 互換の AI アシスタントが Morphik データベースシステムとやり取りできます。

🚀 クイックスタート

MCP サーバーは、Claude や他の MCP 互換の AI アシスタントが Morphik データベースシステムとやり取りするためのインターフェースを提供します。以下の機能をサポートしています。

✨ 主な機能

• ドキュメントの取り込み（テキストとファイル）
• ドキュメントの検索（クエリの関連性に基づく）
• LLM 動的補完付きのドキュメントクエリ
• ドキュメント管理（一覧表示、取得、削除）
• ファイルシステムのナビゲーションとパスからのファイルアップロード

📦 インストール

前提条件

以下のいずれかにアクセスできる必要があります。

• ローカルの Morphik サーバー（localhost:8000 で実行）
• Morphik クラウドプラットフォーム

インストール方法

オプション 1：npx で直接実行（推奨）

# ローカルの Morphik サーバーに接続
npx morphik-mcp

# Morphik クラウドプラットフォームに接続（URI を実際のアドレスに置き換えてください）
npx morphik-mcp --uri=https://api.morphik.ai

# ファイル操作を許可するディレクトリを指定（カンマ区切り）
npx morphik-mcp --allowed-dir=~/Documents,~/Downloads

オプション 2：グローバルインストール

npm install -g morphik-mcp

# ローカルの Morphik サーバーに接続
morphik-mcp

# Morphik クラウドプラットフォームに接続
morphik-mcp --uri=https://api.morphik.ai

# ファイル操作を許可するディレクトリを指定
morphik-mcp --allowed-dir=~/Documents,~/Downloads

オプション 3：ローカル開発

# プロジェクトをビルド
npm run build

# テストを実行
npm test

# 手動でテストを実行
npm run test:manual

💻 使用例

Claude Desktop での設定

# 設定例
CLAUDE_CONFIG_PATH=~/.config/claude/config.json

提供されるツール

ドキュメント管理

• ingest-text：テキスト内容を取り込みます。
• ingest-file：ファイルから内容を取り込みます。
• list-documents：すべてのドキュメントを一覧表示します。
• get-document：指定されたドキュメントの内容を取得します。

クエリ

• query：クエリに関連するドキュメントを返します。
• execute：動的コードを実行して質問に回答します。

ドキュメント管理

• add-to-prompt：ドキュメントをプロンプト履歴に追加します。
• remove-from-prompt：ドキュメントをプロンプト履歴から削除します。
• clear-prompt：すべてのプロンプト履歴をクリアします。

ファイル操作の安全性

セキュリティ上の理由から、ファイル操作はサーバー起動時に明示的に許可されたディレクトリに制限されています。ディレクトリが指定されていない場合、デフォルトではユーザーのホームディレクトリのみが許可されます。サーバーはすべてのファイルパスを検証し、許可されたディレクトリ内にあることを確認し、シンボリックリンクエスケープ攻撃を防止します。

開発

プロジェクトのビルド

npm run build

テストの実行

npm test

手動でのテスト実行

npm run test:manual

📄 ライセンス

ISC