Yapi MCP Server

🚀 yapi-mcp-service MCP サーバー

TypeScript をベースにした MCP サーバーで、シンプルなノートシステムを実装しています。以下の主要な MCP 概念を通じて機能を示しています。

• リソースは URI とメタデータを持つテキストノートを表します。
• ツールは新しいノートを作成するために使用されます。
• プロンプトはノートの要約を生成します。

✨ 主な機能

リソース

• note:// URI を使用してノートを一覧表示およびアクセスします。
• 各ノートにはタイトル、内容、メタデータが含まれています。
• 純粋なテキスト MIME タイプを使用して簡単に内容にアクセスできます。

ツール

• create_note - 新しいテキストノートを作成します。
  • タイトルと内容のパラメータを渡す必要があります。
  • ノートをサーバーの状態に保存します。

プロンプト

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

📦 インストール

開発環境のセットアップ

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

npm install

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

npm run build

自動再構築機能付きで開発します：

npm run watch

Claude Desktop との連携

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 を提供します。