Heatherflux Github Issue MCP Server

🚀 GitHub サーバー MCP サーバー

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

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

✨ 主な機能

リソース

• note:// URI を通じてノートを一覧表示し、アクセスします。
• 各ノートにはタイトル、内容、メタデータが含まれています。
• 単純な内容アクセスには純粋なテキスト 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": {
    "github-server": {
      "command": "/path/to/github-server/build/index.js"
    }
  }
}

デバッグ

MCP サーバーは標準入出力を通じて通信するため、デバッグは難しい場合があります。MCP Inspector をおすすめします。これは以下のパッケージコマンドで実行できます。

npm run inspector

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

💻 使用例

基本的な使用法

以下は、サーバーを開発するための基本的なコマンドです。

依存関係のインストール

npm install

サーバーのビルド

npm run build

自動再構築機能付きの開発

npm run watch