@contextvm/mcp-sdk 1.27.1-contextvm.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Anthropic, PBC
+
+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,141 @@
+# @contextvm/mcp-sdk [![MIT licensed](https://img.shields.io/npm/l/%40contextvm%2Fmcp-sdk)](https://github.com/ContextVM/mcp-sdk/blob/main/LICENSE)
+
+<details>
+<summary>Table of Contents</summary>
+
+- [Overview](#overview)
+- [Fork Scope](#fork-scope)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [Package Exports](#package-exports)
+- [Publishing Notes](#publishing-notes)
+- [Documentation](#documentation)
+- [Contributing](#contributing)
+- [License](#license)
+
+</details>
+
+## Overview
+
+[`@contextvm/mcp-sdk`](package.json) is a lightweight fork of the upstream MCP TypeScript SDK tailored for ContextVM and other local-process integrations that only need the MCP protocol core plus `stdio` transport.
+
+This fork keeps the core protocol runtime and high-level client/server APIs while intentionally removing the HTTP, SSE, WebSocket, Express, Hono, and OAuth-oriented surfaces that added weight without helping the stdio use case.
+
+It makes it easy to:
+
+- Create MCP servers that expose resources, prompts, and tools
+- Build MCP clients that can connect to local MCP servers
+- Use the retained `stdio` transport with a smaller dependency footprint
+
+## Fork Scope
+
+Supported in this package:
+
+- MCP protocol types and schemas
+- Core protocol runtime
+- High-level [`Client`](src/client/index.ts:234) and [`Server`](src/server/index.ts:129) APIs
+- [`McpServer`](src/server/mcp.ts:72)
+- [`StdioClientTransport`](src/client/stdio.ts:92) and [`StdioServerTransport`](src/server/stdio.ts:12)
+- Experimental tasks support
+
+Explicitly not included in this fork:
+
+- Streamable HTTP transport
+- Legacy SSE transport
+- Express and Hono integrations
+- OAuth/auth helper stack
+- Browser/web transport layers
+
+## Installation
+
+```bash
+npm install @contextvm/mcp-sdk zod
+```
+
+This SDK has a required peer dependency on `zod` for schema validation. The package internally imports from `zod/v4`, while remaining compatible with projects using Zod v3.25 or later.
+
+## Quick Start
+
+```typescript
+import { McpServer } from '@contextvm/mcp-sdk/server';
+import { StdioServerTransport } from '@contextvm/mcp-sdk/server/stdio';
+import { z } from 'zod';
+
+const server = new McpServer({
+    name: 'example-server',
+    version: '1.0.0'
+});
+
+server.tool('echo', { message: z.string() }, async ({ message }) => ({
+    content: [{ type: 'text', text: message }]
+}));
+
+const transport = new StdioServerTransport();
+await server.connect(transport);
+```
+
+## Core Concepts
+
+### Servers and transports
+
+An MCP server is typically created with [`McpServer`](src/server/mcp.ts:72) and connected to [`StdioServerTransport`](src/server/stdio.ts:12) for local, process-spawned integrations.
+
+### Tools, resources, prompts
+
+- **Tools** let LLMs ask your server to take actions (computation, side effects, network calls).
+- **Resources** expose read-only data that clients can surface to users or models.
+- **Prompts** are reusable templates that help users talk to models in a consistent way.
+
+The retained server surface still includes tools, resources, prompts, completions, logging, elicitation, sampling, and experimental tasks.
+
+### Capabilities: sampling, elicitation, and tasks
+
+The SDK includes higher-level capabilities for richer workflows:
+
+- **Sampling**: server-side tools can ask connected clients to run LLM completions.
+- **Form elicitation**: tools can request non-sensitive input via structured forms.
+- **URL elicitation**: servers can ask users to complete secure flows in a browser (e.g., API key entry, payments, OAuth).
+- **Tasks (experimental)**: long-running tool calls can be turned into tasks that you poll or resume later.
+
+These higher-level capabilities are preserved in the stdio-focused fork.
+
+### Clients
+
+The high-level [`Client`](src/client/index.ts:234) class connects to MCP servers over the retained [`StdioClientTransport`](src/client/stdio.ts:92) and exposes helpers like `listTools`, `callTool`, `listResources`, `readResource`, `listPrompts`, and `getPrompt`.
+
+### Node.js compatibility
+
+This fork targets Node.js 18+ and is optimized for local stdio-based integrations.
+
+## Package Exports
+
+- `@contextvm/mcp-sdk`
+- `@contextvm/mcp-sdk/client`
+- `@contextvm/mcp-sdk/client/stdio`
+- `@contextvm/mcp-sdk/server`
+- `@contextvm/mcp-sdk/server/stdio`
+- `@contextvm/mcp-sdk/experimental`
+- `@contextvm/mcp-sdk/experimental/tasks`
+
+## Publishing Notes
+
+This package is intended to be published as a public npm package under the [`@contextvm/mcp-sdk`](package.json) name. The published tarball only includes [`dist`](package.json:63) output.
+
+## Documentation
+
+- [Model Context Protocol documentation](https://modelcontextprotocol.io)
+- [MCP Specification](https://spec.modelcontextprotocol.io)
+- [ContextVM fork plan](sdk/FORK_PLAN.md)
+
+## Release Workflow
+
+Build the publishable package with [`npm run build`](package.json:71), inspect the tarball with [`npm pack --dry-run`](package.json), and publish with `npm publish --access public` once the [`@contextvm/mcp-sdk`](package.json:2) scope is ready.
+
+## Contributing
+
+Issues and pull requests are welcome on GitHub at <https://github.com/ContextVM/mcp-sdk>.
+
+## License
+
+This project is licensed under the MIT License—see the [LICENSE](LICENSE) file for details.