Gentleman Book MCP

📚 绅士书MCP服务器

Give AI assistants direct access to the Gentleman Programming Book

Features • Installation • Configuration • Usage • Español

______________________________________________________________________

这是什么？

这是一个 MCP（模型上下文协议）服务器 它允许像克劳德这样的人工智能助手阅读、搜索和理解来自 绅士编程书.

可以把它看作是让你的人工智能助手直接了解18章的软件架构知识、最佳实践和开发智慧。

特性

🔧 第一级：基本工具

📦 第二级：资源和提示

🧠 第三级：语义搜索（人工智能驱动）

同时支持OpenAI和Olama 用于嵌入生成。

安装

先决条件

• 达到1.21或更高
• 这 绅士编程书 本地克隆

从源代码构建

# Clone this repository
git clone https://github.com/Alan-TheGentleman/gentleman-book-mcp.git
cd gentleman-book-mcp

# Build the binary
go build -o bin/gentleman-book-mcp ./cmd/server

# The binary is now at ./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. 安装 奥拉玛
2. 拉动嵌入模型： ollama pull nomic-embed-text
3. 启动Ollama： ollama serve
4. 使用标准配置（Ollama自动检测）

用法

配置后，重新启动Claude Desktop并开始聊天！

示例对话

列出章节：

You: What chapters are in the Gentleman Programming Book?
Claude: [Uses list_chapters] The book has 18 chapters covering...

阅读具体内容：

You: Read me the chapter about hexagonal architecture
Claude: [Uses read_chapter] Here's the hexagonal architecture chapter...

搜索主题：

You: Find information about TDD in the book
Claude: [Uses search_book] I found several mentions of TDD...

语义搜索（如果已配置）：

You: How should I structure a React application for maintainability?
Claude: [Uses semantic_search] Based on the book's recommendations...

使用提示：

You: Explain clean architecture according to the book
Claude: [Uses explain_concept prompt] According to the Gentleman Programming Book...

书籍内容

服务器提供访问 18章 英语和西班牙语：

建筑

gentleman-book-mcp/
├── cmd/
│   └── server/
│       └── main.go              # MCP server entry point
├── internal/
│   ├── book/
│   │   ├── models.go            # Data structures
│   │   └── parser.go            # MDX file parser
│   └── embeddings/
│       └── embeddings.go        # Semantic search engine
├── go.mod
├── go.sum
├── README.md                    # English documentation
└── README.es.md                 # Spanish documentation

发展

# Run in development mode
go run ./cmd/server

# Build
go build -o bin/gentleman-book-mcp ./cmd/server

# Test with MCP Inspector
npx @anthropic-ai/mcp-inspector ./bin/gentleman-book-mcp

故障排除

“书本路径不存在”

确保 BOOK_PATH 环境变量指向书籍MDX文件的正确位置。

“语义搜索不可用”

任一组 OPENAI_API_KEY 或者确保Ollama在安装嵌入式模型的情况下运行。

服务器未响应

检查二进制文件是否具有执行权限： chmod +x ./bin/gentleman-book-mcp

贡献

欢迎投稿！请随意：

• 报告错误
• 建议新功能
• 提交拉取请求

许可证

MIT许可证-请参阅 许可证 了解详情。

相关项目

• 绅士编程书 -书本身
• 模型上下文协议 -MCP规范
• mcp走 -Go SDK for MCP

______________________________________________________________________

Made with ❤️ by Gentleman Programming