@niklaserik/effect-mcp

@niklaserik/effect-mcp

Effect エコシステムの最新ドキュメントを取得することに特化した、Model Context Protocol（MCP）サーバーです。

目的

この MCP サーバーは、AI アシスタントやツールから Effect のドキュメントにリアルタイムでアクセスできるようにします。VS Code 拡張機能やその他の MCP クライアントが、開発者からの次のような質問に答えるため、正確で最新の Effect パッケージドキュメントを取得できます。

• コアの effect パッケージ
• エコシステムパッケージ（@effect/platform、@effect/ai など）
• 安定版と不安定版の両方の Effect パッケージ

サーバーはコード内でインポートされている Effect パッケージをインテリジェントに検出し、質問への回答に最も関連性の高いドキュメントを取得します。

機能

• Effect エコシステムのドキュメントにリアルタイムでアクセス
• 安定版と実験版の両方のパッケージに対応
• インポートに基づくコンテキスト対応のパッケージ検出
• VS Code やその他の MCP 対応クライアントとシームレスに連携
• Effect 開発者の API の使い方に関する質問への回答を支援

このサーバーが公開するもの

• リソース（推奨）
  • 動的テンプレート：effect-docs://{libId}
  • {libId} の補完とリソースの一覧表示に対応
  • 検出用の静的エイリアス：effect-docs://effect、effect-docs://@effect-platform など
  • 現在サポートされているライブラリ：
    • effect
    • @effect/platform
    • @effect/sql
    • @effect/vitest
    • @effect/ai
    • @effect/cli
    • @effect/cluster
    • @effect/rpc
    • @effect/typeclass
• ツール（互換性のため）
  • effect-documentation：選択したライブラリのドキュメントを取得し、連結した Markdown を返します
  • effect-doc-links：上記のリソースへの URI をプレーンテキストで返し、クライアントからアクセスできるようにします

キャッシュと再試行

• 変更されていないドキュメントの再取得を避けるための、メモリ内 TTL キャッシュ（約 10 分）。
• 一時的な取得エラーに対する、短いバックオフを伴う軽量な再試行。

インストール

pnpm add @niklaserik/effect-mcp

使い方

VS Code やその他の MCP クライアントで使用する場合は、カスタム MCP サーバーの追加方法についてクライアントのドキュメントを参照してください。

ローカルでの簡単なテスト：

pnpm install
pnpm build
node dist/index.js # stdio transport

その後、stdio 経由で MCP クライアント（例：MCP Inspector）に接続し、次を試してください。

• リソースを一覧表示し、effect-docs://effect を読み込む
• { "libraries": ["effect", "@effect/platform"] } を指定して、ツール effect-doc-links を呼び出す

初期化手順

• サーバーは、初期化時に MCP 経由で、使用方法に関する簡潔な説明を公開します。これを表示するクライアントが対象です。

開発

# Install dependencies
pnpm install

# Build the project
pnpm build

# Run in development mode with auto-reload
pnpm dev

注意：

• 最新の registerResource／registerTool API を使用し、@modelcontextprotocol/sdk@^1.17.4 で構築されています。
• トランスポート：デフォルトでは stdio。必要に応じて Streamable HTTP に適応できます。

ライセンス

MIT