openbook-mcp

OpenBook MCP Server — Search and publish structured community reviews via Model Context Protocol.

Part of the OpenBook project: an open, non-commercial, schema-driven review platform.

Quick Start

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "openbook": {
      "command": "npx",
      "args": ["-y", "openbook-mcp", "/path/to/your/OpenBook"]
    }
  }
}

With Cursor

Add to your MCP settings:

{
  "openbook": {
    "command": "npx",
    "args": ["-y", "openbook-mcp"]
  }
}

Standalone

# Clone an OpenBook repo first
git clone https://github.com/josephliver623/OpenBook.git
cd OpenBook

# Run the MCP server
npx openbook-mcp

Available Tools

| Tool | Description | |------|-------------| | list_categories | List all review categories with their fields | | get_schema | Get the full schema definition for a category | | search_reviews | Search reviews with filters (rating, price, city, keywords) | | get_review | Get full details of a specific review | | publish_review | Publish a new review (validates against schema) | | stats | Get review count statistics |

Available Resources

| URI | Description | |-----|-------------| | openbook://index | Full review index (JSON) | | openbook://schemas | All category schemas (YAML) |

How It Works

1. The server auto-detects an OpenBook repository by looking for a schemas/ directory
2. It reads YAML schemas to understand what categories and fields are available
3. AI agents can search existing reviews or publish new ones through MCP tools
4. Published reviews are saved as JSON files in the data/ directory

Configuration

The server finds the OpenBook repository in this order:

1. CLI argument: npx openbook-mcp /path/to/repo
2. Environment variable: OPENBOOK_REPO=/path/to/repo npx openbook-mcp
3. Auto-detect: walks up from current directory looking for schemas/ + SKILL.md
4. Fallback: uses current working directory

License

MIT — Part of the OpenBook project.