Backlog MCP Server MCP Server

🚀 バックログ MCP サーバー

TypeScript をベースにした MCP サーバーで、シンプルなノートシステムを実装しています。この実装を通じて、MCP の核心概念を以下のようにデモンストレーションしています。

• リソース：note:// URI を使用して、タイトル、内容、メタデータを持つノートにアクセスし管理します。
• ツール：新しいノートを作成します。
• プロンプト：保存されたすべてのノートの要約を生成します。

✨ 主な機能

リソース

• note:// URIs を通じてノートを一覧表示し、アクセスできます。
• 各ノートにはタイトル、内容、メタデータが含まれています。
• 内容のアクセスには、シンプルな純テキストの MIME タイプを使用します。

ツール

• create_note：新しいテキストノートを作成します。
  • タイトルと内容のパラメータを必ず提供する必要があります。
  • ノートはサーバーの状態に保存されます。

プロンプト

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

📦 インストール

Claude Desktop と一緒に使用するには、サーバーの設定を追加してください。

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

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

デバッグ

MCP サーバーは標準入出力を通じて通信するため、デバッグは難しい場合があります。MCP Inspector の使用をおすすめします。これは以下のスクリプトコマンドで提供できます。

npm run inspector

Inspector はブラウザでアクセスできるデバッグツールの URL を提供します。

💻 使用例

基本的な使用法

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

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

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

🔧 技術詳細

開発

依存関係のインストールには npm install を使用します。サーバーの構築には npm run build を実行します。自動再構築機能付きの開発環境を使用するには、npm run watch を実行します。

インストール

Claude Desktop と連携するためには、特定の設定ファイルにサーバーの設定を追加する必要があります。MacOS と Windows では設定ファイルの場所が異なります。

デバッグ

MCP サーバーは標準入出力を通じて通信するため、デバッグが難しい場合があります。そのため、MCP Inspector を使用することでデバッグを容易に行うことができます。