mcpField
K
Koma Core MCP

Koma Core MCP

ローカル
github.comメモリ・ナレッジ132 週間前に更新
リポジトリ公式サイト

Koma Core MCP について

Koma Core MCP は、公開メタデータの検索とアクセス階層に応じた文書取得を通じて、保護された RAG ストレージを AI エージェントに公開します。発見と認可を分離するインメモリのリファレンス実装です。

主な機能

  1. 01公開文書インデックスの検索
  2. 02ソース ID による全文取得
  3. 03アクセス階層に基づく権限確認
  4. 04カテゴリやタグによる検索絞り込み

活用シーン

  1. 01本文を公開せずにエージェントが文書を発見
  2. 02ユーザーのアクセス階層に応じた文書取得
  3. 03RAG ワークフローの認可境界を実証

MCP 対応

メタデータのみを返す `search_docs` と、指定された `userTier` が文書の階層を満たす場合に全文を返す `retrieve_doc` を提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "swnotmetal-koma-core": {
      "command": "npx",
      "args": [
        "-y",
        "koma-core-mcp"
      ],
      "env": {
        "KOMA_MASTER_KEY": "<KOMA_MASTER_KEY>"
      }
    }
  }
}
起動コマンドnpx -y koma-core-mcp
設定が必要な環境変数
KOMA_MASTER_KEYシークレットHKDF master key for content tokens (demo key fallback if unset)

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmkoma-core-mcp0.1.1

ツール

2

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
tagstringいいえタグで絞り込みます（例："api"、"guide"）
limitnumberいいえ返す結果の最大数。デフォルト：20
categorystringいいえカテゴリで絞り込みます（例："docs"、"internal"）

詳細

Koma Core MCP

Koma Core の保護された RAG ストレージを、AI エージェント向けの MCP ツールとして公開します。

npm install koma-core-mcp

このプロジェクトで実演する内容

発見 ≠ 認可。 エージェントは公開インデックスを検索できますが、非公開コンテンツを取得するには、適切なアクセス階層が必要です。

ツール内容アクセス
search_docs公開インデックスを検索します。メタデータのみを返し、コンテンツは返しません公開
retrieve_docソース ID を指定して全文を取得しますuserTier がドキュメントの階層以上であることが必要

セットアップ

# Optional: set a master key for token derivation (default is a demo key)
export KOMA_MASTER_KEY=your-32-byte-minimum-secret
Claude Desktop
{
  "mcpServers": {
    "koma-core": {
      "command": "npx",
      "args": ["-y", "koma-core-mcp"]
    }
  }
}

ツール

search_docs
  • category（任意）— カテゴリで絞り込みます
  • tag（任意）— タグで絞り込みます
  • limit（任意）— 結果の最大件数

メタデータのみを返します：displayName、category、tags、accessTier、preview。コンテンツもトークンも返しません。

retrieve_doc
  • sourceId（必須）— search_docs で取得したドキュメントのソース ID
  • userTier（必須）— public | premium | enterprise

userTier がドキュメントの階層以上の場合にのみ、全文を返します。

シードデータ

起動時に、デモ用ドキュメント 3 件が取り込まれます。

sourceId階層
guide-getting-started公開
api-referenceプレミアム
internal-architectureエンタープライズ

セキュリティ境界

これはインメモリのリファレンス実装です。永続化機能はなく、デモ用のマスターキーを使用します。本番環境では、実際のデータベースに対応する DatabaseAdapter インターフェースを実装し、実際のマスターキーを用意してください。セキュリティ境界の詳細については、koma-core の README を参照してください。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。