yapi-mcp-server

yapi-mcp-service 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": {
    "yapi-mcp-service": {
      "command": "/path/to/yapi-mcp-service/build/index.js"
    }
  }
}

デバッグ

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

npm run inspector

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