Use This MCP client To

Integrate MCP servers into TypeScript projects using fetch API Develop cross-platform MCP clients for Node, Deno, and Zuplo Implement remote MCP server communication in web and server environments Build modular AI workflows with standardized MCP client-server interactions Create real-time context sharing between LLMs and external data sources

README

`@zuplo/mcp`

A fetch API based, remote server first, TypeScript SDK for MCP.
About · Documentation · Contributing

🚧 Warning! In active development! 🚧

Attributions

Inspired by (with MIT Licensed attributions) - modelcontextprotocol/typescript-sdk

🚀 About

@zuplo/mcp is a remote server first MCP SDK that aims to be "minimum common API" compliant as defined by the WinterTC. It uses the fetch APIs and is intended to work out of the box on Zuplo, Node, Deno, Workerd, etc.

📝 Documentation

Quickstart

Create an MCP server:

const server = new MCPServer({
  name: "Example Server",
  version: "1.0.0",
});

Add some tools:

server.addTool({
  name: "add",
  description: "Adds two numbers together and returns the result.",
  validator: new ZodValidator(
    z.object({
      a: z.number().describe("First number"),
      b: z.number().describe("Second number")
    })
  ),
  handler: async ({ a, b }) => ({
    content: [{ type: "text", text: String(a + b) }],
    isError: false,
  })
});

Wire up your MCP server with a transport:

const transport = new HTTPStreamableTransport()
await transport.connect();

server.withTransport(transport);

Handle a Request:

const response = await transport.handleRequest(httpRequest);

🤝 Contributing

See the CONTRIBUTING.md for further details.

mcp FAQ

How do I install the @zuplo/mcp SDK?

You can install it via npm or yarn using 'npm install @zuplo/mcp' or 'yarn add @zuplo/mcp'.

Which environments does @zuplo/mcp support?

It supports environments with fetch API like Zuplo, Node.js, Deno, and Workerd.

Is @zuplo/mcp compliant with any standards?

Yes, it aims to be compliant with the minimum common API standard defined by WinterTC.

Can I use @zuplo/mcp to connect to any MCP server?

Yes, it is designed to work with any MCP server implementing the MCP protocol.

Does @zuplo/mcp support TypeScript?

Yes, it is a TypeScript SDK designed for type safety and developer experience.

Is @zuplo/mcp production ready?

It is currently in active development, so use with caution in production environments.