Gentleman Book MCP

🚀 📚 紳士プログラミングブックMCPサーバー

このサーバーは、ClaudeなどのAIアシスタントが紳士プログラミングブックの内容を読み、検索し、理解することを可能にするMCP（Model Context Protocol）サーバーです。AIアシスタントに、ソフトウェアアーキテクチャの知識、ベストプラクティス、開発の知恵が詰まった18章の内容に直接アクセスする手段を与えるようなものです。

🚀 クイックスタート

このMCPサーバーを使用することで、AIアシスタントが紳士プログラミングブックの内容を活用できるようになります。まずはインストールと設定を行い、その後に使用方法を確認しましょう。

✨ 主な機能

🔧 レベル1：基本ツール

📦 レベル2：リソースとプロンプト

🧠 レベル3：意味検索（AI駆動）

埋め込み生成にはOpenAIとOllamaの両方をサポートしています。

📦 インストール

前提条件

• Go 1.21以上
• 紳士プログラミングブックをローカルにクローン

ソースからビルド

# このリポジトリをクローン
git clone https://github.com/Alan-TheGentleman/gentleman-book-mcp.git
cd gentleman-book-mcp

# バイナリをビルド
go build -o bin/gentleman-book-mcp ./cmd/server

# バイナリは./bin/gentleman-book-mcpに配置されます

インストールの確認

./bin/gentleman-book-mcp --help

🔧 設定

環境変数

Claude Desktopの設定

macOSの場合は~/Library/Application Support/Claude/claude_desktop_config.json、Windowsの場合は%APPDATA%\Claude\claude_desktop_config.jsonに以下を追加します。

{
  "mcpServers": {
    "gentleman-book": {
      "command": "/absolute/path/to/gentleman-book-mcp",
      "env": {
        "BOOK_PATH": "/path/to/gentleman-programming-book/src/data/book"
      }
    }
  }
}

OpenAIを使用する場合（意味検索用）

{
  "mcpServers": {
    "gentleman-book": {
      "command": "/absolute/path/to/gentleman-book-mcp",
      "env": {
        "BOOK_PATH": "/path/to/gentleman-programming-book/src/data/book",
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

Ollamaを使用する場合（無料、ローカル）

1. Ollamaをインストール
2. 埋め込みモデルを取得：ollama pull nomic-embed-text
3. Ollamaを起動：ollama serve
4. 標準設定を使用（Ollamaは自動検出されます）

💻 使用例

基本的な使用法

設定が完了したら、Claude Desktopを再起動してチャットを開始しましょう！

会話例

章の一覧表示

あなた: 紳士プログラミングブックにはどんな章がありますか？
Claude: [list_chaptersを使用] このブックには18章あり、...をカバーしています。

特定の内容の読み取り

あなた: ヘキサゴナルアーキテクチャに関する章を読んでください。
Claude: [read_chapterを使用] これがヘキサゴナルアーキテクチャの章です...

トピックの検索

あなた: ブック内でTDDに関する情報を探してください。
Claude: [search_bookを使用] TDDに関するいくつかの記述を見つけました...

意味検索（設定されている場合）

あなた: Reactアプリケーションを保守性の高いものにするにはどうすればいいですか？
Claude: [semantic_searchを使用] ブックの推奨事項に基づいて...

プロンプトの使用

あなた: ブックによるクリーンアーキテクチャを説明してください。
Claude: [explain_conceptプロンプトを使用] 紳士プログラミングブックによると...

ブックの内容

サーバーは英語とスペイン語の18章にアクセスできるようにします。

アーキテクチャ

gentleman-book-mcp/
├── cmd/
│   └── server/
│       └── main.go              # MCPサーバーのエントリポイント
├── internal/
│   ├── book/
│   │   ├── models.go            # データ構造
│   │   └── parser.go            # MDXファイルのパーサー
│   └── embeddings/
│       └── embeddings.go        # 意味検索エンジン
├── go.mod
├── go.sum
├── README.md                    # 英語のドキュメント
└── README.es.md                 # スペイン語のドキュメント

開発

# 開発モードで実行
go run ./cmd/server

# ビルド
go build -o bin/gentleman-book-mcp ./cmd/server

# MCPインスペクターでテスト
npx @anthropic-ai/mcp-inspector ./bin/gentleman-book-mcp

トラブルシューティング

"Book path does not exist"

BOOK_PATH環境変数がブックのMDXファイルの正しい場所を指していることを確認してください。

"Semantic search not available"

OPENAI_API_KEYを設定するか、Ollamaが埋め込みモデルをインストールして実行されていることを確認してください。

サーバーが応答しない

バイナリに実行権限があることを確認してください：chmod +x ./bin/gentleman-book-mcp

コントリビューション

コントリビューションは大歓迎です！以下のことを自由に行ってください。

• バグ報告
• 新機能提案
• プルリクエストの提出

📄 ライセンス

MITライセンス - 詳細はLICENSEを参照してください。

関連プロジェクト

• 紳士プログラミングブック - ブック本体
• Model Context Protocol - MCP仕様
• mcp-go - MCP用のGo SDK