{"_id":"@cognitive-swarm/mcp","name":"@cognitive-swarm/mcp","dist-tags":{"latest":"0.2.0"},"versions":{"0.2.0":{"name":"@cognitive-swarm/mcp","version":"0.2.0","description":"MCP (Model Context Protocol) integration for cognitive-swarm agents","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"build":"tsc","test":"vitest run","test:watch":"vitest","lint":"eslint src/","clean":"rm -rf dist"},"dependencies":{"@cognitive-swarm/core":"*","@modelcontextprotocol/sdk":"^1.29.0"},"license":"Apache-2.0","author":{"name":"Dmitry Zorin"},"repository":{"type":"git","url":"git+https://github.com/medonomator/cognitive-swarm.git","directory":"packages/mcp"},"publishConfig":{"access":"public"},"homepage":"https://medonomator.github.io/cognitive-swarm/","bugs":{"url":"https://github.com/medonomator/cognitive-swarm/issues"},"gitHead":"8613f7b139c03719ef14fe9f2c01bdc1c5532a26","_id":"@cognitive-swarm/mcp@0.2.0","_nodeVersion":"24.11.1","_npmVersion":"11.6.2","dist":{"integrity":"sha512-HVJc5FAmL7bxl7P+/LiP7zsWB98Pvj5zm0ostdtT1d1cm6VUYQL7EtGZBRucP5sYX1QNgo7LbOr0DSqWnxFU8w==","shasum":"ce18726801c39ad0f02b044d35be579e12613787","tarball":"https://registry.npmjs.org/@cognitive-swarm/mcp/-/mcp-0.2.0.tgz","fileCount":30,"unpackedSize":33727,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIGV5rAhrntdKDH6SGx+rnJXxH0jIPnKUVyX0zyBtri88AiBSdxbREhhP0B4twh1DNgphO6vp+LZWcKTnnadSwtMpVg=="}]},"_npmUser":{"name":"medonomator","email":"budteschastlivi1@gmail.com"},"directories":{},"maintainers":[{"name":"medonomator","email":"budteschastlivi1@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.2.0_1776497159779_0.8696590532005131"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-18T07:25:59.637Z","0.2.0":"2026-04-18T07:25:59.907Z","modified":"2026-04-18T07:26:00.219Z"},"maintainers":[{"name":"medonomator","email":"budteschastlivi1@gmail.com"}],"description":"MCP (Model Context Protocol) integration for cognitive-swarm agents","homepage":"https://medonomator.github.io/cognitive-swarm/","repository":{"type":"git","url":"git+https://github.com/medonomator/cognitive-swarm.git","directory":"packages/mcp"},"author":{"name":"Dmitry Zorin"},"bugs":{"url":"https://github.com/medonomator/cognitive-swarm/issues"},"license":"Apache-2.0","readme":"# @cognitive-swarm/mcp\n\nMCP (Model Context Protocol) integration for cognitive-swarm agents.\n\n## Installation\n\n```bash\nnpm install @cognitive-swarm/mcp\n```\n\n## Overview\n\nBridges cognitive-swarm agents with MCP tool servers. The package handles tool discovery, prompt injection, response parsing, and execution. Use `createToolSupport` for a quick all-in-one setup, or compose the lower-level classes for fine-grained control.\n\n## Usage\n\n```ts\nimport { createToolSupport } from '@cognitive-swarm/mcp';\n\n// Quick setup -- returns registry, executor, prompt builder, and parser\nconst tools = await createToolSupport({\n  servers: [{ name: 'fs', command: 'mcp-fs' }],\n});\n\n// Inject available tools into an agent's system prompt\nconst prompt = tools.promptBuilder.build(tools.registry.listTools());\n\n// Parse tool calls from agent output\nconst calls = tools.responseParser.parse(agentOutput);\n\n// Execute a tool call\nconst result = await tools.executor.execute(calls[0]);\n```\n\n### Lower-level API\n\n```ts\nimport {\n  McpToolRegistry,\n  McpToolExecutor,\n  ToolPromptBuilder,\n  ToolResponseParser,\n} from '@cognitive-swarm/mcp';\n\nconst registry = new McpToolRegistry();\nconst executor = new McpToolExecutor(registry);\nconst promptBuilder = new ToolPromptBuilder();\nconst parser = new ToolResponseParser();\n```\n\n## Exports\n\n| Export               | Kind     | Description                              |\n| -------------------- | -------- | ---------------------------------------- |\n| `createToolSupport`  | Function | All-in-one setup helper                  |\n| `McpToolRegistry`    | Class    | Discovers and stores available tools     |\n| `McpToolExecutor`    | Class    | Executes tool calls against MCP servers  |\n| `ToolPromptBuilder`  | Class    | Builds system prompt sections for tools  |\n| `ToolResponseParser` | Class    | Parses tool calls from agent output      |\n| `McpTool`            | Type     | Tool definition                          |\n| `ToolCall`           | Type     | Parsed tool invocation                   |\n| `ToolResult`         | Type     | Result from tool execution               |\n\n## Links\n\n- [Root repository](https://github.com/medonomator/cognitive-swarm)\n","readmeFilename":"README.md","_rev":"1-f9646fa8ad7a15ce867bc523ad62e39d"}