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 サーバーは stdio を通じて通信するため、デバッグは難しい場合があります。MCP Inspector の使用をおすすめします。これはパッケージスクリプトとして利用できます。

npm run inspector

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

💻 使用例

基本的な使用法

依存関係のインストール

npm install

サーバーのビルド

npm run build

自動再ビルド機能付きの開発

npm run watch