Dewey

@meetdewey/mcp

Dewey 用の MCP サーバーです。Claude、Cursor、および MCP 対応のあらゆるエージェントから、ドキュメントコレクションを検索・調査できます。詳しくは完全な API リファレンスをご覧ください。

インストール

claude_desktop_config.json（または同等の MCP クライアント設定）に追加します。

{
  "mcpServers": {
    "dewey": {
      "command": "/bin/sh",
      "args": ["-lc", "npx -y @meetdewey/mcp"],
      "env": {
        "DEWEY_API_KEY": "dwy_live_...",
        "DEWEY_COLLECTION_ID": "..."
      }
    }
  }
}

Windows ユーザー向けの注意： "command": "/bin/sh" と "args": ["-lc", "npx -y @meetdewey/mcp"] を "command": "npx" と "args": ["-y", "@meetdewey/mcp"] に置き換えてください。ログインシェルのラッパーが必要なのは macOS/Linux のみです。これは、Claude Desktop が引き継がない Homebrew と nvm の PATH エントリーを読み込むためです。

環境変数

変数	必須	説明
DEWEY_API_KEY	はい	Dewey プロジェクトの API キー
DEWEY_COLLECTION_ID	いいえ	デフォルトのコレクション ID。設定すると、collection_id を受け取るツールはこの値を既定値として使用します。
DEWEY_API_URL	いいえ	API のベース URL を上書きします（デフォルト：https://api.meetdewey.com/v1）

利用可能なツール

検索と調査

ツール	説明
dewey_list_collections	プロジェクト内のすべてのコレクションを一覧表示します。設定されている場合は、説明と調査指示も含まれます
dewey_search	チャンクの内容を対象に、セマンティック検索とキーワード検索を組み合わせて実行します
dewey_scan_sections	セクションのタイトルと要約を対象に、軽量な検索を実行します
dewey_research	深さを設定できるエージェント型の調査クエリです。根拠と引用を含む回答を返します
dewey_get_section	ID を指定して、セクションの Markdown 全文を取得します

ドキュメント管理

ツール	説明
dewey_list_documents	コレクション内のドキュメントを処理状況とともに一覧表示します
dewey_get_document_sections	ドキュメント内のすべてのセクションを一覧表示します（見出しレベルと ID を含む目次）
dewey_get_document_markdown	ドキュメントを変換した Markdown 全文を取得します
dewey_retry_document	失敗したドキュメントを再試行します。エラー状態をクリアし、処理キューに再登録します
dewey_delete_document	ドキュメントと、そこから派生したすべてのデータを完全に削除します

主張と矛盾

ツール	説明
dewey_list_claims	コレクションまたは特定のドキュメントから抽出された事実に関する主張を一覧表示します。重要度（1～5）で絞り込めます
dewey_list_contradictions	検出された矛盾を一覧表示します。説明と解決案を含む、相反する主張のクラスターです
dewey_detect_contradictions	コレクション内のすべての主張を対象に、矛盾検出を非同期で開始します
dewey_get_contradiction_run	最新の矛盾検出実行のステータスと統計情報を取得します（dewey_detect_contradictions の後にポーリングするために使用します）
dewey_resolve_contradiction	矛盾に解決指示を適用するか、矛盾を却下します

重複排除

ツール	説明
dewey_detect_duplicates	重複排除を非同期で開始します。チャンク間で共有される内容を測定して類似ドキュメントを特定し、各クラスターで 1 つのドキュメントを正規ドキュメントとして設定します
dewey_get_duplicate_run	最新の重複排除実行のステータスと統計情報を取得します（dewey_detect_duplicates の後にポーリングするために使用します）
dewey_list_duplicate_groups	正規ドキュメントとメンバー、およびカバー率を含む類似ドキュメントのグループを一覧表示します
dewey_promote_duplicate_canonical	別のメンバーを正規ドキュメントに昇格させます。以前の正規ドキュメントは near_duplicate になります
dewey_disband_duplicate_group	グループを解散します。元のメンバーはそれぞれ独立したドキュメントとして検索対象に戻ります

正規ドキュメント以外は、検索と矛盾検出の対象から除外されます。この機能を使用するには、コレクションで enableDeduplication: true を設定してください（dewey_update_collection または Dewey ダッシュボードから設定できます）。

コレクションの設定

ツール	説明
dewey_get_collection_stats	ドキュメント数、ストレージ、セクション／チャンク／主張の数、および処理状況の内訳を取得します
dewey_update_collection	コレクション名、説明、リサーチ指示、公開範囲、機能フラグを更新します
dewey_recompute_summaries	すべてのドキュメントで AI によるセクション要約を再実行します（例：LLM モデルの変更後）
dewey_recompute_captions	すべてのドキュメント内のすべての画像と表について、AI によるキャプション生成を再実行します
dewey_delete_collection	コレクションとそのすべてのデータを完全に削除します

リサーチ指示

コレクションには自然言語による指示を設定でき、リサーチシステムのプロンプトに自動的に挿入されます。たとえば、単位、優先する情報源、情報が不足している場合の対処方法などを指定できます。指示は Dewey ダッシュボード、API、または dewey_update_collection から直接設定できます。dewey_resolve_contradiction を使用して解決策を適用すると、提案された指示もここに自動的に追加されます。

ツールの使用パターン

一般的な読み取り専用のリサーチワークフロー：

1. dewey_list_collections — 利用可能なコレクションを見つけ、その目的を把握します
2. dewey_scan_sections — ドキュメントの構造をすばやく調べ、関連するセクションを特定します
3. dewey_get_section — 特定のセクションの全文を読み込みます
4. dewey_search — 焦点を絞った質問に最も関連性の高いチャンクを取得します
5. dewey_research — 複数段階の推論が必要な質問に対し、エージェント型の包括的なリサーチクエリを実行します

より詳細な分析とキュレーションを行うには：

1. dewey_get_collection_stats — どれだけのコンテンツが処理されたかを評価します
2. dewey_list_claims — ドキュメント全体から最も重要な事実を抽出します
3. dewey_list_contradictions — ドキュメント間で意見が食い違っている箇所を特定します
4. dewey_resolve_contradiction — 各矛盾を適用または却下し、コレクションの指示を自動的に更新します

ライセンス

MIT