@orkestrel/mcp 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Orkestrel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,75 @@
+# @orkestrel/mcp
+
+A typed [Model Context Protocol](https://modelcontextprotocol.io) client/server
+for the `@orkestrel` line, with pluggable HTTP, WebSocket, and stdio
+transports. `createMCPServer` wraps a live `ToolManagerInterface`
+(`@orkestrel/agent`) as an MCP server; `createMCPClient` drives a remote MCP
+server and surfaces its tools as local `ToolInterface`s an agent can call as
+if they were its own. The dispatch core is transport- and provider-agnostic
+(`src/core` — JSON-RPC 2.0, no HTTP, no `as`); every transport (Streamable
+HTTP over `@orkestrel/router` / `@orkestrel/server`, WebSocket over
+`@orkestrel/websocket`, and stdio over `node:child_process`) lives one layer
+out (`src/server`), each mechanism, not policy. Part of the `@orkestrel` line.
+
+## Install
+
+```sh
+npm install @orkestrel/mcp
+```
+
+## Requirements
+
+- Node.js >= 24
+- ESM and CommonJS builds ship for both the core and server entry points
+- `@orkestrel/server` and `@orkestrel/router` are peer dependencies (the HTTP
+  spine the `./server` transports mount onto)
+
+## Usage
+
+Expose a tool registry over MCP, mounted on the HTTP spine:
+
+```ts
+import { createMCPServer } from '@orkestrel/mcp'
+import { createMCPRoutes } from '@orkestrel/mcp/server'
+import { createToolManager } from '@orkestrel/agent'
+
+const tools = createToolManager()
+tools.add({ id: 'add', name: 'add', execute: (a) => Number(a.x) + Number(a.y) })
+
+const mcp = createMCPServer({ name: 'calculator', version: '1.0.0', tools })
+const routes = createMCPRoutes(mcp) // POST /mcp dispatches JSON-RPC (JSON or SSE per Accept)
+router.add(routes)
+```
+
+Drive a remote MCP server as a client, over the same transport-agnostic core:
+
+```ts
+import { createMCPClient } from '@orkestrel/mcp'
+import { createHTTPClientTransport } from '@orkestrel/mcp/server'
+
+const client = createMCPClient({
+	transport: createHTTPClientTransport({ url: 'http://localhost:3000/mcp' }),
+})
+await client.connect()
+const tools = await client.tools()
+const value = await client.call('add', { x: 2, y: 5 })
+```
+
+The SAME `MCPClient` drives a `createWebSocketClientTransport` or
+`createStdioClientTransport` instead — only the injected transport changes.
+
+## Guide
+
+For the full surface — the JSON-RPC dispatch core, the three server
+transports (HTTP, WebSocket, stdio), the native session middleware, and
+usage patterns — see [`guides/src/mcp.md`](guides/src/mcp.md).
+
+## Package
+
+Published with two entry points per the `exports` field in `package.json`:
+the environment-agnostic core (`.`) and the Node-only server surface
+(`./server`).
+
+## License
+
+MIT © [Orkestrel](https://github.com/orkestrel) — see [LICENSE](./LICENSE).