Search1api

🚀 MCP TypeScript SDK

The Model Context Protocol (MCP) implemented in TypeScript, offering both client - side and server - side functionalities for seamless integration into large language models (LLMs).

📚 Documentation

The Model Context Protocol enables applications to provide context information to large language models in a standardized way, separating context provision from actual language model interactions. This TypeScript SDK fully implements the MCP specification, making it easy to:

• Build clients that can connect to any MCP server.
• Create MCP servers that expose resources, prompts, and tools.
• Utilize standard transport protocols such as stdio and SSE.
• Handle all MCP protocol messages and lifecycle events.

📦 Installation

npm install @modelcontextprotocol/sdk

🚀 Quick Start

Create a Client

import { Client } from "@modelcontextprotocol/sdk/client";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio";

const transport = new StdioClientTransport({
  command: "path/to/server",
});

const client = new Client({
  name: "example-client",
  version: "1.0.0",
});

await client.connect(transport);

// List available resources
const resources = await client.request(
  { method: "resources/list" },
  ListResourcesResultSchema
);

// Read a specific resource
const resourceContent = await client.request(
  {
    method: "resources/read",
    params: {
      uri: "file:///example.txt"
    }
  },
  ReadResourceResultSchema
);

Create a Server

import { Server } from "@modelcontextprotocol/sdk/server";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio";

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

server.setRequestHandler(ListResourcesRequestSchema, async () => {
  return {
    resources: [
      {
        uri: "file:///example.txt",
        name: "Example Resource",
      },
    ],
  };
});

server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
  if (request.params.uri === "file:///example.txt") {
    return {
      contents: [
        {
          uri: "file:///example.txt",
          mimeType: "text/plain",
        }
      ]
    };
  }
});

await server.start(new StdioServerTransport());