MCP Server

MCP Server

The repository includes a Model Context Protocol server, mcp/server.mjs. It lets an AI client such as Claude Code or Claude Desktop browse, search, quote and typeset the book. It runs over stdio.

Setup

git clone https://github.com/The-Studio-of-Sadiq/Advanced-Chemistry
cd Advanced-Chemistry
npm install

Claude Code. The repo ships a project .mcp.json, so opening the folder in Claude Code offers the server automatically. To register it globally instead:

claude mcp add advanced-chemistry -- node /absolute/path/to/Advanced-Chemistry/mcp/server.mjs

Claude Desktop and other clients. Add this to the client's MCP configuration:

{
  "mcpServers": {
    "advanced-chemistry": {
      "command": "node",
      "args": ["/absolute/path/to/Advanced-Chemistry/mcp/server.mjs"]
    }
  }
}

Tools

Tool	Arguments	Returns
list_contents	with_sections	Every chapter and appendix with its id, title and section headings
read_part	id ("5", "S6", "A"), optional section ("5.3" or a title word)	Markdown of a whole part or one section
search_book	query, regex, parts, context, max_results	Matching lines with chapter, section, file and line number
list_figures	optional id	Figure paths and captions
get_figure	path	The figure as an image
build_pdf	optional parts, out	Path to the built PDF, plus any math or image problems

Resources and prompts

• Resources use the template book://part/{id}, which gives the Markdown of each chapter or appendix. Clients that support resources can attach a whole chapter as context.
• Prompt explain_section(id, section) walks through a section using the book's own method: physical question → derivation → status of each principle → chemical consequence.

Example requests

• "Search the book for Franck–Condon and explain the derivation in 13.x."
• "Show me Figure 12.2 and explain why cyclobutadiene is antiaromatic."
• "Build a PDF of Chapters 15 and 16 only."