MCP State Server

🚀 状態サーバー MCP サーバー

TypeScript ベースの MCP サーバーで、シンプルなノートシステムを実装しています。このサーバーは、以下の方法で核心的な MCP 概念をデモンストレーションしています。

• note:// URI を通じて、タイトル、内容、メタデータを持つリソース（Resource）を一覧表示し、アクセスする
• 新しいノートを作成するツール
• すべての保存されたノートの要約を生成するプロンプト

✨ 主な機能

リソース

• note:// URI を使用してノートを列挙し、アクセスする
• 各ノートにはタイトル、内容、メタデータがある
• 内容のアクセスには、簡単な純テキストの MIME タイプを使用する

ツール

• create_note - 新しいテキストノートを作成する
  • タイトルと内容は必須パラメータです
  • ノートをサーバーの状態に保存する

プロンプト

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

📦 インストール

Claude デスクトップと一緒に使用するには、サーバー設定を追加してください。

MacOS では：~/Library/Application Support/Claude/claude_desktop_config.json Windows では：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "state-server": {
      "command": "/path/to/state-server/build/index.js"
    }
  }
}

デバッグ

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

npm run inspector

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

💻 使用例

基本的な使用法

# 依存関係のインストール
npm install

高度な使用法

# サーバーのビルド
npm run build

# 自動再構築機能付きの開発
npm run watch