codebase-explorer MCP Server

codebase-explorer MCP サーバー

Model Context Protocol サーバー

これは、シンプルなメモシステムを実装した TypeScript ベースの MCP サーバーです。以下を提供し、MCP の基本概念を紹介します。

• URI とメタデータを持つテキストメモを表すリソース
• 新しいメモを作成するツール
• メモの要約を生成するプロンプト

機能

リソース

• note:// URI を使ってメモを一覧表示し、アクセスできます
• 各メモにはタイトル、内容、メタデータがあります
• コンテンツに簡単にアクセスできるプレーンテキストの MIME タイプ

ツール

• create_note - 新しいテキストメモを作成します
  • 必須パラメーターとしてタイトルと内容を受け取ります
  • メモをサーバーの状態に保存します

プロンプト

• summarize_notes - 保存されているすべてのメモの要約を生成します
  • すべてのメモの内容を埋め込みリソースとして含めます
  • LLM による要約のための構造化されたプロンプトを返します

開発

依存関係をインストールします：

npm install

サーバーをビルドします：

npm run build

自動再ビルドを有効にして開発する場合：

npm run watch

インストール

Claude Desktop で使用するには、サーバーの設定を追加します。

MacOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "codebase-explorer": {
      "command": "/path/to/codebase-explorer/build/index.js"
    }
  }
}

デバッグ

MCP サーバーは stdio 経由で通信するため、デバッグが難しい場合があります。パッケージスクリプトとして利用できる MCP Inspector の使用をおすすめします。

npm run inspector

Inspector は、ブラウザーでデバッグツールにアクセスするための URL を表示します。