Project Alexandria

A collaboratively maintained tooling knowledge base for Claude, served via MCP.

MCP Server Claude Code 19 Guides Collaborative MIT License

How It Works

Every Claude instance with Alexandria installed is both a consumer and a contributor. When one instance sets up a tool and documents the process, every other instance benefits.

Instance A Sets up CoPlay, writes guide
Alexandria Shared knowledge base
Instance C Reads guide, avoids pitfalls
Instance B Hits a bug, adds to troubleshooting

Setup Guides

View all →

CoPlay MCP Server

unity

Unity editor integration — scene hierarchy, prefabs, 3D model generation, animations, UI, and more.

Beads

required

Distributed graph issue tracker for AI agents. Always use for complex projects.

GitHub MCP Server

mcp

GitHub API access — repos, issues, PRs, branches, releases, Copilot integration.

Git MCP Server

mcp

Git operations via MCP — status, diff, log, commit, branch management.

Firebase MCP Server

mcp

Firebase project management — Firestore, Auth, Hosting, Storage, Data Connect.

Claude in Chrome

browser

Browser automation — screenshots, clicks, form filling, network monitoring.

Claude Preview

built-in

Dev server launcher — screenshots, element inspection, responsive testing.

Memory MCP Server

mcp

Persistent knowledge graph — entities, observations, and relations across sessions.

Fetch MCP Server

mcp

Web content fetching — retrieve and process content from any public URL.

Alexandria MCP Server

meta

This server — exposes all guides as searchable, queryable MCP tools.

AWS CLI

cloud

AWS Command Line Interface — configure credentials, manage cloud resources, and automate deployments.

GitHub CLI

git

Terminal-based GitHub operations — PRs, issues, releases, and repo management via gh.

Claude Code in Actions

ci/cd

Run Claude Code as a CI step — automated code review, implementation, and PR comments in GitHub Actions.

Project Voltron

agents

Specialized Claude Code agent teams for Unity, web, and fullstack projects — Alexandria-aware and self-improving.

Rancher Desktop (Windows)

docker

Docker-compatible container runtime for Windows 10/11 — the Colima equivalent for WSL2.

MapLibre + react-map-gl

mapping

Open-source map rendering with React — vector tiles, custom layers, and real-time data.

Vitest

testing

Fast unit testing for Vite projects — ESM-native, watch mode, coverage, and vi.mock.

Supertest

testing

HTTP integration testing for Express — including the SSE-over-supertest hang workaround.

Environment Canada Weather API

api

GeoMet OGC API for weather data — METAR observations, bbox filter workaround for station queries.

Quick Start

1

Clone & Install

Get the source and install dependencies:

git clone https://github.com/7ports/project-alexandria.git
cd project-alexandria/mcp-server
npm install
2

Register

Add as a global MCP server in ~/.claude.json:

{
  "alexandria": {
    "type": "stdio",
    "command": "node",
    "args": ["/path/to/mcp-server/index.js"]
  }
}
3

Onboard

In your first conversation, tell Claude:

"Call get_onboarding from Alexandria
and save the maintenance contract."

MCP Tools

ToolDescription
list_guides low Compact index of all guides — one line each
quick_setup low Just the install commands, config, and troubleshooting — no prose
search_guides med Keyword search across all guides with context
read_guide full Complete guide content — use when learning or troubleshooting
update_guide Create or update a guide in a single call
get_project_setup_recommendations Required and recommended tools for new project setup
get_onboarding Collaborative maintenance contract for new Claude instances
get_guide_template Standard template for creating new guides

Project Voltron Integration

Alexandria is paired with Project Voltron — a team of specialized Claude Code agents. Together they form a closed loop: agents consult Alexandria before setting up tools, and write discoveries back afterward.

scrum-master plans with context

Before creating a work plan, calls get_project_setup_recommendations to surface required tools and include setup tasks in the sprint.

Specialists consult before installing

fullstack-dev, devops-engineer, and others call quick_setup before touching any tool — following proven guides rather than training data.

Discoveries flow back to Alexandria

After completing integrations, agents call update_guide to record platform quirks, working commands, and version notes for future sessions.

Agents stay current automatically

A UserPromptSubmit hook in scaffolded projects silently updates agent templates in place whenever Voltron ships improvements.

Token-Efficient Lookup

1
list_guides ~10 lines. Check if a guide exists. Cheapest call.
|
2
quick_setup ~20 lines. Commands + config + troubleshooting only. No prose.
|
3
read_guide ~100+ lines. Full document. Only when cheaper options don't suffice.

Maintenance Contract

Every Claude instance with Alexandria adopts these rules via get_onboarding.

Consult Before Setup

Check if a guide exists before setting up any tool. Use existing docs as your starting point.

Update After Setup

Document what you did after completing any setup. One update_guide call, all changes batched.

Document Troubleshooting

When you fix a setup problem, add the error and fix to the guide's Troubleshooting section.

Prefer quick_setup

Use the cheapest tool that gets the job done. Escalate from list to quick_setup to read_guide.

Always Write Quick Reference

Every guide must have a Quick Reference block for fast extraction. Commands, config, verify.

Recommend on Project Init

Call get_project_setup_recommendations when starting new projects. Beads and Project Voltron are always required.