Statewave

@statewavedev/mcp-server

Statewave MCP サーバー — Statewave のメモリを MCP 対応クライアント（コーディングアシスタント、エージェントフレームワーク、IDE 拡張機能）に公開します。

Statewave Connectors エコシステムの一部です。ベンダー中立を設計方針としており、IDE、モデルプロバイダー、ホスト型サービスへの依存を前提としていません。

含まれるもの

• STATEWAVE_MCP_TOOLS — 標準的なツールセット（5 つのツール、JSON Schema 入力）
• StatewaveClient — Statewave v1 API 用の軽量 HTTP クライアント（認証、テナント、型付きエラー）
• dispatchTool — 入力を検証し、ツール呼び出しを StatewaveClient のメソッドにマッピングするディスパッチャー
• startMcpServer — 最小限の stdio JSON-RPC 2.0 トランスポートと --list-tools モード

ツール

ツール	目的
statewave_ingest_episode	正規化されたエピソードを 1 件取り込みます（idempotency_key に基づいて重複を排除します）。
statewave_search_memories	サブジェクト内の自由記述クエリで、コンパイル済みメモリを検索します。
statewave_get_context	サブジェクトの簡潔でランク付けされたコンテキストを取得します。プロンプト内で使用する既定のツールです。
statewave_get_timeline	サブジェクトのエピソードを時系列で取得します。kinds、since、until で絞り込めます。
statewave_compile_subject	サブジェクトのコンパイルを開始し、新たに取り込んだエピソードを想起できるようにします。

使い方

# As a CLI subcommand (via @statewavedev/connectors-cli)
statewave-connectors mcp start --list-tools     # print the JSON Schema surface and exit
statewave-connectors mcp start                  # stdio JSON-RPC 2.0 server (requires STATEWAVE_URL)

# Or programmatically inside an existing MCP runtime
import { StatewaveClient, dispatchTool } from "@statewavedev/mcp-server";
const client = new StatewaveClient({ url: process.env.STATEWAVE_URL!, apiKey: process.env.STATEWAVE_API_KEY });
const { result } = await dispatchTool(client, "statewave_get_context", {
  subject: "repo:owner/name",
  query: "repo conventions and recent changes",
});

ステータス

v0.1.0 プレビュー — 最小限の stdio トランスポートが含まれています。RELEASE_NOTES.md を参照してください。