{"_id":"@blackwell-systems/bun-mcp-assert","_rev":"2-858695fe696f9d2262d5638feb1a6700","name":"@blackwell-systems/bun-mcp-assert","dist-tags":{"latest":"0.12.3"},"versions":{"0.12.2":{"name":"@blackwell-systems/bun-mcp-assert","version":"0.12.2","keywords":["bun","mcp","testing","assertions","model-context-protocol"],"author":{"name":"Blackwell Systems","email":"dayna@blackwell-systems.com"},"license":"MIT","_id":"@blackwell-systems/bun-mcp-assert@0.12.2","maintainers":[{"name":"daynajblackwell","email":"dayna@blackwell-systems.com"}],"homepage":"https://github.com/blackwell-systems/mcp-assert","bugs":{"url":"https://github.com/blackwell-systems/mcp-assert/issues"},"dist":{"shasum":"2dafa8709f138d811d1b51b08aebbc938560fcb0","tarball":"https://registry.npmjs.org/@blackwell-systems/bun-mcp-assert/-/bun-mcp-assert-0.12.2.tgz","fileCount":7,"integrity":"sha512-oqD27F8TBpXLGvXt34xAqbMgmA2XBEgAV95yj9mOG+TfJqPp+cyRsjim7ERSn+BrKXPsXhJny9xKOiKnFT8tKg==","signatures":[{"sig":"MEUCIHryzZpptt/tQBL2+8BVypRrRgAxvFuNNaFkUlxc5NvdAiEAm5S9w9uUZQ05V59rRY9yKCilQxygeg0Bcuq7/NUqG+E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8218},"main":"src/index.ts","types":"src/index.ts","gitHead":"c71b2438751ebddcb96fa6429281feb7c0aec8aa","scripts":{},"_npmUser":{"name":"daynajblackwell","email":"dayna@blackwell-systems.com"},"repository":{"url":"git+https://github.com/blackwell-systems/mcp-assert.git","type":"git","directory":"bun-plugin"},"_npmVersion":"10.8.2","description":"Bun test integration for mcp-assert: run MCP server assertion YAML files as Bun tests","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"peerDependencies":{"bun-types":">=1.0.0"},"_npmOperationalInternal":{"tmp":"tmp/bun-mcp-assert_0.12.2_1780555920151_0.6955903417352365","host":"s3://npm-registry-packages-npm-production"}},"0.12.3":{"name":"@blackwell-systems/bun-mcp-assert","version":"0.12.3","description":"Bun test integration for mcp-assert: run MCP server assertion YAML files as Bun tests","main":"src/index.ts","types":"src/index.ts","scripts":{},"keywords":["bun","mcp","testing","assertions","model-context-protocol"],"author":{"name":"Blackwell Systems","email":"dayna@blackwell-systems.com"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/blackwell-systems/mcp-assert.git","directory":"bun-plugin"},"homepage":"https://github.com/blackwell-systems/mcp-assert","peerDependencies":{"bun-types":">=1.0.0"},"_id":"@blackwell-systems/bun-mcp-assert@0.12.3","gitHead":"927afecba3edcd90270816884757ebecb7056a01","bugs":{"url":"https://github.com/blackwell-systems/mcp-assert/issues"},"_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-lcnlVO02tH9EbVPKMeFxNenb+WPjLXxlmeRctAxkdjene+JyiCoXXJw+AdVU+bl/zQuI1Awr1D5LuDUK9hsulw==","shasum":"cb67ed10e33d0aa9c4392912be945a0fcd071998","tarball":"https://registry.npmjs.org/@blackwell-systems/bun-mcp-assert/-/bun-mcp-assert-0.12.3.tgz","fileCount":7,"unpackedSize":8218,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD/gtnIpMHT8Argnp2UbOhGtmrxgwfQ7cYg5Ce+VR+vWQIhAKLd9Zvcuz/TRGxC8cA6aM7KjF8L5trriZH51rEy4DYT"}]},"_npmUser":{"name":"daynajblackwell","email":"dayna@blackwell-systems.com"},"directories":{},"maintainers":[{"name":"daynajblackwell","email":"dayna@blackwell-systems.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/bun-mcp-assert_0.12.3_1780601761808_0.5661359802807442"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-04T06:51:59.930Z","modified":"2026-06-04T19:36:02.091Z","0.12.2":"2026-06-04T06:52:00.280Z","0.12.3":"2026-06-04T19:36:01.964Z"},"bugs":{"url":"https://github.com/blackwell-systems/mcp-assert/issues"},"author":{"name":"Blackwell Systems","email":"dayna@blackwell-systems.com"},"license":"MIT","homepage":"https://github.com/blackwell-systems/mcp-assert","keywords":["bun","mcp","testing","assertions","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/blackwell-systems/mcp-assert.git","directory":"bun-plugin"},"description":"Bun test integration for mcp-assert: run MCP server assertion YAML files as Bun tests","maintainers":[{"name":"daynajblackwell","email":"dayna@blackwell-systems.com"}],"readme":"# @blackwell-systems/bun-mcp-assert\n\nBun test integration for [mcp-assert](https://github.com/blackwell-systems/mcp-assert). Run MCP server assertion YAML files as Bun tests.\n\nSame YAML files work across Bun, Jest, Vitest, pytest, and the CLI.\n\n## Install\n\n```bash\nbun add -d @blackwell-systems/bun-mcp-assert @blackwell-systems/mcp-assert\n```\n\n## Usage\n\n### Suite mode (auto-discover YAML files)\n\n```ts\n// mcp.test.ts\nimport { describeMcpSuite } from \"@blackwell-systems/bun-mcp-assert\"\n\ndescribeMcpSuite(\"my mcp server\", \"evals/\")\n```\n\nEach YAML file in `evals/` becomes a Bun test case. Run with `bun test`.\n\n### Single assertion mode\n\n```ts\nimport { test } from \"bun:test\"\nimport { runMcpAssert } from \"@blackwell-systems/bun-mcp-assert\"\n\ntest(\"echo tool returns message\", () => {\n  runMcpAssert(\"evals/echo.yaml\")\n})\n\ntest(\"greet tool with timeout\", () => {\n  runMcpAssert(\"evals/greet.yaml\", { timeout: \"60s\" })\n})\n```\n\n### Options\n\n```ts\nrunMcpAssert(\"evals/echo.yaml\", {\n  timeout: \"30s\",           // per-assertion timeout\n  fixture: \"test/fixtures\", // {{fixture}} substitution\n  server: \"bun server.ts\",  // server override\n  binary: \"/path/to/mcp-assert\", // explicit binary path\n})\n```\n\n## How it works\n\n@blackwell-systems/bun-mcp-assert is a thin bridge. It uses `Bun.spawnSync` to call the mcp-assert Go binary with `--json`, parses the result, and maps it to Bun test pass/fail outcomes.\n\nBinary resolution (in order):\n1. Explicit `binary` option\n2. `Bun.which(\"mcp-assert\")` (PATH lookup, native)\n3. `@blackwell-systems/mcp-assert` npm package\n\n## License\n\nMIT\n","readmeFilename":"README.md"}