Power your agent
Yayıncının kendi komutu. PlugMCP uç noktası değildir.
Host a copy with our keys and logs.
npx -y @pharaoh-so/[email protected]Claude Code'un yerel komutlar için kurulum bağlantısı yok. Aşağıdaki komutu kopyalayın ve bir terminalde çalıştırın.
claude mcp add pharaoh-so-mcp -- npx -y @pharaoh-so/mcp@0.3.85Bir terminalde çalıştırın.
{ "mcpServers": { "pharaoh-so-mcp": { "command": "npx", "args": [ "-y", "@pharaoh-so/[email protected]" ] } }}claude_desktop_config.json
Uzak URL mi, yoksa makinenizde bir komut mu? İki kurulum arasındaki fark
PlugMCP’de çalıştır
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
BaşlatYayıncıdan
MCP proxy for Pharaoh — maps codebases into queryable knowledge graphs for AI agents.
Pharaoh developer install for Claude Code, Codex and Claude Desktop: architecture tools, shell queries and agent workflows.
Pharaoh gives AI coding assistants a complete architectural map of your codebase: every function, dependency, module, and connection. Instead of reading files one at a time, your AI agent queries the knowledge graph and gets instant answers about blast radius, unused code, dependency chains, and more.
This package enables Claude Code to connect to Pharaoh in headless environments (VPS, SSH, containers, CI) where a browser isn't available for OAuth. It acts as a stdio-to-SSE proxy, presenting itself as a local MCP server while relaying all communication to the remote Pharaoh server.
Run the proxy directly to trigger the device authorization flow:
npx @pharaoh-so/mcp
This displays a device code and a URL. Open the URL on any device (phone, laptop, tablet) and enter the code to authorize. Credentials are saved to ~/.pharaoh/credentials.json and remain valid for 7 days, with automatic re-authorization when they expire.
npx @pharaoh-so/mcp
Verify the connection:
claude mcp list
You should see pharaoh listed as a stdio server.
If you previously added Pharaoh as an SSE server, remove it first:
claude mcp remove pharaoh
npx @pharaoh-so/mcp
Claude Code ← stdio → @pharaoh-so/mcp ← SSE/HTTP → mcp.pharaoh.so
The proxy implements the Model Context Protocol (MCP) specification:
Authentication uses RFC 8628 (OAuth 2.0 Device Authorization Grant) — no browser is needed on the machine running Claude Code.
Once connected, Pharaoh provides these MCP tools:
Use --inspect to dump the full tool manifest as JSON (useful for MCP registry validation and debugging):
npx @pharaoh-so/mcp --inspect
This outputs the complete list of tools with their schemas and exits immediately, without connecting to the server.
Usage: pharaoh-mcp [options]
Options:
--server <url> Pharaoh server URL (default: https://mcp.pharaoh.so)
--logout Clear stored credentials and exit
--inspect Output tool manifest as JSON and exit
--help Show help
--version Show version number
Credentials are stored at ~/.pharaoh/credentials.json with 0600 permissions (owner-read/write only). The file contains:
To clear credentials:
npx @pharaoh-so/mcp --logout
For self-hosted Pharaoh instances or development, register manually, pinned to a version (npx @pharaoh-so/mcp --version prints the one you have):
claude mcp add --scope user pharaoh -- npx @pharaoh-so/mcp@<version> --server https://your-pharaoh-instance.com
0600 — owner-read/write only)npx @pharaoh-so/mcp in a terminal is the interactive setup. Every later proxy start (Claude Code launching the server) repeats the plugin, skill and command steps so a new version takes effect, and nothing else.
Versions 0.3.46 and earlier wrote one rule, mcp__pharaoh, on every proxy start. That prefix auto-approved every Pharaoh tool, including account deletion and pharaoh_admin, so a prompt injection could run them without a human prompt. The next interactive setup replaces that rule with the list above; account deletion, pharaoh_admin and any tool not listed prompt before they run. To take the blanket rule out by hand, delete mcp__pharaoh from permissions.allow.
Every registration the setup writes runs the exact version that wrote it (npx @pharaoh-so/mcp@<version>). A new release on npm changes nothing on your machine until you upgrade:
npx @pharaoh-so/mcp@latest
This signs you in again, rewrites the registration with the new version and refreshes the plugin. The interactive setup asks the npm registry for the newest version and prints a one-line hint when there is one; proxy starts never check.
If you discover a security vulnerability, please report it responsibly by emailing [email protected]. Do not open a public issue.
The Pharaoh server may be temporarily unavailable. Check status.pharaoh.so or try again in a few minutes.
Re-authenticate by running the proxy directly:
npx @pharaoh-so/mcp
Or clear credentials and start fresh:
npx @pharaoh-so/mcp --logout
npx @pharaoh-so/mcp
claude mcp listMake sure you added it with the correct command:
npx @pharaoh-so/mcp
Note the -- separator between pharaoh and npx.
The first run after installation may take a moment as npm downloads the package. Subsequent runs use the cached version. To pre-install globally:
npm install -g @pharaoh-so/mcp
claude mcp add --scope user pharaoh -- pharaoh-mcp
Pharaoh parses your repositories using tree-sitter and maps structural metadata into a Neo4j knowledge graph. The graph contains:
No source code is stored — only structural metadata. When an AI agent queries Pharaoh, it gets architectural facts in minimal tokens, not raw code dumps. This means your AI assistant can understand your entire codebase architecture without consuming its context window reading files one by one.
Contributions are welcome. Please open an issue first to discuss what you'd like to change.
git checkout -b feature/amazing-feature)git commit -m 'Add amazing feature')git push origin feature/amazing-feature)MIT -- Pharaoh, Inc.
Pharaoh developer install for Claude Code, Codex and Claude Desktop: architecture tools, shell queries and agent workflows.
{ "mcpServers": { "pharaoh-so-mcp": { "command": "npx", "args": [ "-y", "@pharaoh-so/[email protected]" ] } }}Araçlar
Henüz araç listesi yok. Uzak sunucular ilk sağlık kontrolünden sonra bir liste alır.
SSS
Bu sayfadan Cursor, Claude Desktop, Claude Code veya VS Code için stdio yapılandırmasını kopyalayın. PlugMCP proxy'sini değil, yayıncının kurulumunu kullanır.
Bu kayıtta gerekli bir ortam değişkeni listelenmiyor.
@pharaoh So/mcp yerel olarak stdio üzerinden çalışır.
Son kontrol: 2026-11-14. Pharaoh developer install for Claude Code, Codex and Claude Desktop: architecture tools, shell queries and agent workflows.