{"_id":"@act-spec/mcp-bridge","name":"@act-spec/mcp-bridge","dist-tags":{"rc":"0.2.0-rc.1","latest":"0.2.0-rc.1"},"versions":{"0.2.0-rc.1":{"name":"@act-spec/mcp-bridge","version":"0.2.0-rc.1","description":"PRD-602 ACT-MCP bridge for the ACT (Agent Content Tree) v0.1 reference implementation. Wraps a PRD-500 ActRuntime (or a multi-mount BridgeConfig.mounts array per amendment A4) and exposes ACT nodes as MCP 1.0 resources under the canonical act:// URI schem","license":"Apache-2.0","author":{"name":"Jeremy Forsythe","email":"jeremy@act-spec.org"},"homepage":"https://act-spec.org","bugs":{"url":"https://github.com/act-spec/act/issues"},"type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/act-spec/act.git","directory":"packages/mcp-bridge"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","@act-spec/core":"0.2.0-rc.1","@act-spec/runtime-core":"0.2.0-rc.1","@act-spec/validator":"0.2.0-rc.1"},"devDependencies":{"@vitest/coverage-v8":"^2.1.9","tsx":"^4.19.2","typescript":"^5.6.3","vitest":"^2.1.4"},"scripts":{"build":"tsc -p tsconfig.json","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage","lint":"eslint src","typecheck":"tsc -p tsconfig.json --noEmit","conformance":"tsx conformance.ts"},"_id":"@act-spec/mcp-bridge@0.2.0-rc.1","_integrity":"sha512-yRZ3SkjSYNfq93mv/qMb/HJofvmvxdMIVH0pA6VJYBR52Tf3o7DyJFBUmc/vVuGYwkwx4wPm7PGvS7lE81s74Q==","_resolved":"/private/var/folders/yp/y7frhcvj70jgr6b8g633lghr0000gn/T/78f00417c4d29da636500ecbe0406072/act-spec-mcp-bridge-0.2.0-rc.1.tgz","_from":"file:act-spec-mcp-bridge-0.2.0-rc.1.tgz","_nodeVersion":"22.19.0","_npmVersion":"11.6.0","dist":{"integrity":"sha512-yRZ3SkjSYNfq93mv/qMb/HJofvmvxdMIVH0pA6VJYBR52Tf3o7DyJFBUmc/vVuGYwkwx4wPm7PGvS7lE81s74Q==","shasum":"56de4c8a7f304f58755ab700941efff6d00be04a","tarball":"https://registry.npmjs.org/@act-spec/mcp-bridge/-/mcp-bridge-0.2.0-rc.1.tgz","fileCount":56,"unpackedSize":316004,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIGgZ1N00n8y9q/81DbiCffAVBz3mMLFHoMEnzJSANZBkAiBZpVmvR7gBQwxetnpBC2beQ5h/mNglMly3IRoQNqfZXA=="}]},"_npmUser":{"name":"jdforsythe","email":"jdforsythe@gmail.com"},"directories":{},"maintainers":[{"name":"jdforsythe","email":"jdforsythe@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-bridge_0.2.0-rc.1_1777915315547_0.037778612092570496"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-04T17:21:55.385Z","0.2.0-rc.1":"2026-05-04T17:21:55.725Z","modified":"2026-05-04T17:21:56.014Z"},"maintainers":[{"name":"jdforsythe","email":"jdforsythe@gmail.com"}],"description":"PRD-602 ACT-MCP bridge for the ACT (Agent Content Tree) v0.1 reference implementation. Wraps a PRD-500 ActRuntime (or a multi-mount BridgeConfig.mounts array per amendment A4) and exposes ACT nodes as MCP 1.0 resources under the canonical act:// URI schem","homepage":"https://act-spec.org","repository":{"type":"git","url":"git+https://github.com/act-spec/act.git","directory":"packages/mcp-bridge"},"author":{"name":"Jeremy Forsythe","email":"jeremy@act-spec.org"},"bugs":{"url":"https://github.com/act-spec/act/issues"},"license":"Apache-2.0","readme":"# @act-spec/mcp-bridge\n\nACT-MCP bridge for ACT (Agent Content Tree). Wraps an `ActRuntime` (or a\nmulti-mount `BridgeConfig.mounts` array) and exposes ACT nodes as MCP 1.0\nresources under the canonical `act://` URI scheme. Single-source and\nmulti-mount construction (runtime + static walker mixes) are both\nsupported.\n\n## Status\n\nACT v0.1 internal hand-test candidate. Public release lands at v0.2.\n\n## Install\n\nUnpublished in v0.1. Consume via the workspace:\n\n```jsonc\n// package.json\n{ \"dependencies\": { \"@act-spec/mcp-bridge\": \"workspace:*\" } }\n```\n\n## Usage\n\nSingle-source (runtime-backed) bridge:\n\n```ts\nimport { createActMcpBridge } from '@act-spec/mcp-bridge';\nimport { createRuntime } from '@act-spec/runtime-core';\n\nconst runtime = createRuntime({ /* … */ });\n\nconst bridge = createActMcpBridge({\n  mcp: { name: 'acme-bridge', version: '0.1.0' },\n  host: 'acme.example.com',\n  identity: { /* IdentityBridge */ },\n  runtime,\n});\n\nawait bridge.start(stdioTransport);\n```\n\nMulti-mount bridge — mix a runtime mount with a static walker mount:\n\n```ts\nimport { createActMcpBridge, readStaticSource } from '@act-spec/mcp-bridge';\n\nconst bridge = createActMcpBridge({\n  mcp: { name: 'acme-bridge', version: '0.1.0' },\n  host: 'acme.example.com',\n  identity,\n  mounts: [\n    { prefix: 'live',    runtime },\n    { prefix: 'archive', staticSource: await readStaticSource('./public/act') },\n  ],\n});\n```\n\nURI helpers (no bridge required):\n\n```ts\nimport { buildResourceUri, buildManifestUri } from '@act-spec/mcp-bridge';\n\nconst uri = buildResourceUri('acme.example.com', ['live'], 'node-123');\n// => 'act://acme.example.com/live/n/node-123'\n```\n\nThe conformance harness (`runMcpEnumerationProbe`) verifies that the union\nof bridge-enumerated `act://` resources equals the static-emitted +\nruntime-served node IDs.\n\n## Conformance / what's tested\n\nEvery public API has a citing test in the package's test suite, including\nthe construction-time validation set (`BridgeConfigurationError` for\npartial-validity, missing `IdentityBridge`, prefix coherence, `act_version`\npin, and host checks), the URI scheme, the outcome → MCP error mapper\n(`mapOutcomeToMcpError`), and the static walker drift-prevention contract.\nThe conformance gate runs `runMcpEnumerationProbe` against the bundled\nfixtures.\n\n```bash\npnpm -F @act-spec/mcp-bridge conformance\n```\n\n## Configuration (selected)\n\n| Option | Notes |\n| --- | --- |\n| `mcp.name` / `mcp.version` | MCP server identity. |\n| `host` | URI host segment; validated by `isValidMcpHost`. |\n| `identity` | `IdentityBridge` — required. |\n| `runtime` | Single-source mount (`ActRuntime`). |\n| `mounts` | Multi-mount alternative; array of `BridgeMount`. |\n| `act_version` | Pinned to the supported ACT version. |\n\n## Peer / runtime dependencies\n\n| Dependency | Range |\n| --- | --- |\n| `@modelcontextprotocol/sdk` | `^1.29.0` (bundled) |\n| `@act-spec/runtime-core` | workspace |\n\nThe transport is host-supplied. v0.1 ships stdio compatibility; HTTP+SSE\ntransports are wired by the host application.\n\n## Links\n\n- Runtime core: [`@act-spec/runtime-core`](../runtime-core)\n- Repository: <https://github.com/act-spec/act>\n","readmeFilename":"README.md","_rev":"1-6082c1fb1e15b2dd5515828ee60c2cf7"}