{"_id":"@capybaralabs/hive-mcp","name":"@capybaralabs/hive-mcp","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@capybaralabs/hive-mcp","version":"0.1.0","description":"MCP server for HIVE — exposes a HIVE queen as native tools to Claude Desktop, Claude Code, Cursor, OpenClaw, and any MCP-aware host.","license":"BUSL-1.1","type":"module","bin":{"hive-mcp":"dist/index.js"},"main":"./dist/index.js","engines":{"node":">=18.0.0"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsx src/index.ts","prepublishOnly":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.23.0","zod-to-json-schema":"^3.23.0"},"devDependencies":{"@types/node":"^22.0.0","tsx":"^4.19.0","typescript":"^5.5.0"},"repository":{"type":"git","url":"git+https://github.com/capybarist/hive-mcp.git"},"keywords":["mcp","model-context-protocol","hive","rag","knowledge-base","claude","anthropic"],"gitHead":"28f5b748cf6e5bf3f7ef8ffa9fac92658e5809e8","types":"./dist/index.d.ts","_id":"@capybaralabs/hive-mcp@0.1.0","bugs":{"url":"https://github.com/capybarist/hive-mcp/issues"},"homepage":"https://github.com/capybarist/hive-mcp#readme","_nodeVersion":"24.14.0","_npmVersion":"11.9.0","dist":{"integrity":"sha512-SfZx5c1rf4JboQGtFR74DijbUqb1DZ93lb1AFDlDxukrTvL+rg4lB6EirtMcLONTUM1xUj8vRtoirTs8ri4d6Q==","shasum":"b90bf3dec96942499becf0cbae75ff3e1c842d01","tarball":"https://registry.npmjs.org/@capybaralabs/hive-mcp/-/hive-mcp-0.1.0.tgz","fileCount":11,"unpackedSize":23047,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIBKxVIPDCO0dNk3rqWGuBOz9c8MTYKXB/9DGu5DCiUFvAiB/OnoGBvt/1qYPubX9OsvNbS/uMc7klGwrGxRXgN+oCg=="}]},"_npmUser":{"name":"capybarist","email":"capy@capybaralabs.tech"},"directories":{},"maintainers":[{"name":"capybarist","email":"capy@capybaralabs.tech"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/hive-mcp_0.1.0_1780041427502_0.3430959228347219"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-29T07:57:07.361Z","0.1.0":"2026-05-29T07:57:07.643Z","modified":"2026-05-29T07:57:07.851Z"},"maintainers":[{"name":"capybarist","email":"capy@capybaralabs.tech"}],"description":"MCP server for HIVE — exposes a HIVE queen as native tools to Claude Desktop, Claude Code, Cursor, OpenClaw, and any MCP-aware host.","homepage":"https://github.com/capybarist/hive-mcp#readme","keywords":["mcp","model-context-protocol","hive","rag","knowledge-base","claude","anthropic"],"repository":{"type":"git","url":"git+https://github.com/capybarist/hive-mcp.git"},"bugs":{"url":"https://github.com/capybarist/hive-mcp/issues"},"license":"BUSL-1.1","readme":"# @capybaralabs/hive-mcp\n\nMCP server that exposes a **HIVE** queen as native tools to any MCP-aware LLM host:\nClaude Desktop, Claude Code, Cursor, Continue, Goose, [OpenClaw](https://openclaw.io/), and others.\n\nHIVE is a decentralized, verifiable knowledge base for LLMs — peer-to-peer extraction\nof signed knowledge fragments, embedded vector search, optional LLM synthesis.\nThis package is the bridge between any MCP-aware client and a running HIVE queen.\n\nReference: [USE-CASES.md → case 14](https://github.com/capybarist/hive/blob/main/docs/USE-CASES.md#14--mcp-server) in the HIVE repo.\n\n## Install\n\nUse directly (no install) for the canonical setup in a Claude Desktop / Cursor MCP config:\n\n```bash\nnpx @capybaralabs/hive-mcp\n```\n\nOr install globally:\n\n```bash\nnpm install -g @capybaralabs/hive-mcp\nhive-mcp\n```\n\n## Configuration\n\nTwo environment variables:\n\n| Variable | Required | Default | Purpose |\n|---|---|---|---|\n| `HIVE_QUEEN_URL` | no | `http://localhost:8090` | Base URL of the queen's HTTP API |\n| `HIVE_API_KEY` | when queen auth is enabled (v0.9+) | (none) | Bearer token sent as `Authorization` header |\n\n### Claude Desktop\n\n`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) /\n`%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"hive\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@capybaralabs/hive-mcp\"],\n      \"env\": {\n        \"HIVE_QUEEN_URL\": \"https://your-queen.example.com\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add hive npx -y @capybaralabs/hive-mcp \\\n  -e HIVE_QUEEN_URL=https://your-queen.example.com\n```\n\n### Cursor\n\n`~/.cursor/mcp.json` (same JSON shape as Claude Desktop).\n\n### OpenClaw\n\nDiscovered automatically by `mcporter` from npm — see\n[docs.openclaw.ai/cli/mcp](https://docs.openclaw.ai/cli/mcp).\n\n## Tools\n\n| Tool | Purpose |\n|---|---|\n| `hive_query` | Retrieve signed knowledge fragments matching a free-text query. Returns top-k fragments with score, snippet, URL, signing bee. **No LLM synthesis** — the calling LLM (Claude/Cursor) composes the answer from the fragments. |\n| `hive_list_sources` | List the bees registered on this queen and the sources each one declares. Useful for discovery. |\n\n### Why no LLM synthesis in the MCP path?\n\nHIVE's product is the **information** (signed fragments with provenance), not\nthe prose. When called from an MCP host, the host's own LLM (Claude Sonnet,\nCursor's model, etc.) is invariably stronger than any model the queen-side\nmight call — running fragments through a weaker LLM and then a stronger one\nis redundant and loses fidelity. So `hive_query` returns raw fragments and\nlets the host LLM synthesise.\n\nThe queen's `/api/query` endpoint still supports LLM synthesis (`use_llm: true`)\n— it's used by the queen's own web UI, by non-MCP integrations, and by\n[case 06 (Local AI · fully-offline stack)](https://github.com/capybarist/hive/blob/main/docs/USE-CASES.md#06--local-ai--fully-offline-stack).\nJust not from MCP.\n\n## Develop\n\n```bash\ngit clone https://github.com/capybarist/hive-mcp\ncd hive-mcp\nnpm install\nnpm run dev   # runs from src/ with tsx (no build step)\nnpm run build # emits dist/\n```\n\nPoint at a local HIVE queen running on `http://localhost:8090` (default), or set\n`HIVE_QUEEN_URL` to a remote one.\n\n## Transport\n\nstdio only in v0.1 — the universal denominator across MCP hosts. SSE / HTTP-streamable\ntransports are tracked for v0.2 (needed for remote multi-user queens).\n\n## License\n\nBUSL-1.1 — same as HIVE.\n","readmeFilename":"README.md","_rev":"1-2b8b8decb1aa1e2bd2625c4e7c5620c0"}