Gentleman Book MCP

🚀 紳士編程書籍MCP服務器

本項目是一個MCP（模型上下文協議）服務器，能讓Claude等AI助手讀取、搜索和理解紳士編程書籍的內容。相當於為你的AI助手直接打通了獲取18章軟件架構知識、最佳實踐和開發智慧的渠道。

🚀 快速開始

本項目是一個 MCP（模型上下文協議）服務器，允許Claude等AI助手讀取、搜索和理解紳士編程書籍的內容。可以將其視為為你的AI助手提供了一條直達18章軟件架構知識、最佳實踐和開發智慧的通道。

✨ 主要特性

🔧 一級：基礎工具

📦 二級：資源與提示

🧠 三級：語義搜索（人工智能驅動）

支持使用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桌面端設置

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "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桌面端並開始聊天！

示例對話

列出章節：

你：紳士編程書籍有哪些章節？
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 環境變量指向書籍MDX文件的正確位置。

"語義搜索不可用"

設置 OPENAI_API_KEY 或確保Ollama正在運行並安裝了嵌入向量模型。

服務器無響應

檢查二進制文件是否有執行權限：chmod +x ./bin/gentleman-book-mcp

貢獻

歡迎貢獻！可以自由地：

• 報告錯誤
• 建議新功能
• 提交拉取請求

📄 許可證

本項目採用MIT許可證，詳情請參閱 LICENSE。

相關項目

• 紳士編程書籍 - 書籍本身
• 模型上下文協議 - MCP規範
• mcp-go - MCP的Go SDK

由 紳士編程 用心打造