Skip to main content
Glama
anhkhoa289

MCP Playground

by anhkhoa289
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
JavaScript
Hybrid

MCP Playground

MCP (Model Context Protocol) server với hỗ trợ cả hai phương thức transport:

  • Pure MCP SDK (Stdio) - Standard input/output transport

  • SSE Transport (Server-Sent Events) - HTTP-based transport

Tính năng

  • ✅ Hỗ trợ Pure MCP SDK với Stdio transport

  • ✅ Hỗ trợ SSE (Server-Sent Events) transport

  • ✅ Các công cụ (tools) ví dụ: echo, add, get_time, generate_uuid

  • ✅ Các tài nguyên (resources) ví dụ: server info, example data

  • ✅ TypeScript với type safety đầy đủ

  • ✅ Development mode với hot reload

Related MCP server: Echo MCP Server

Cài đặt

npm install

Sử dụng

1. Stdio Transport (Pure MCP SDK)

Chạy server với stdio transport:

# Development mode
npm run dev

# Production mode
npm run build
npm start

Server sẽ giao tiếp qua stdin/stdout, phù hợp cho việc tích hợp với Claude Desktop hoặc các MCP clients khác.

Cấu hình cho Claude Desktop

Thêm vào file cấu hình Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "mcp-playground": {
      "command": "node",
      "args": ["/path/to/mcp-playground/dist/index.js"]
    }
  }
}

Hoặc trong development mode:

{
  "mcpServers": {
    "mcp-playground": {
      "command": "npx",
      "args": ["tsx", "/path/to/mcp-playground/src/index.ts"]
    }
  }
}

2. SSE Transport (Server-Sent Events)

Chạy server với SSE transport:

# Development mode
npm run dev:sse

# Production mode
npm run build
npm run start:sse

Server sẽ chạy trên http://localhost:3000 với các endpoints:

  • GET /health - Health check

  • GET /sse - SSE connection endpoint

  • POST /messages - Client message endpoint

Kết nối với SSE Client

Sử dụng MCP Client để kết nối:

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";

const transport = new SSEClientTransport(
  new URL("http://localhost:3000/sse")
);

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

await client.connect(transport);

API

Tools (Công cụ)

echo

Phản hồi lại tin nhắn được gửi.

Input:

{
  "message": "Hello, World!"
}

Output:

Echo: Hello, World!

add

Cộng hai số với nhau.

Input:

{
  "a": 5,
  "b": 3
}

Output:

5 + 3 = 8

get_time

Trả về thời gian hiện tại của server.

Input:

{}

Output:

Current server time: 2024-01-15T10:30:00.000Z

generate_uuid (chỉ SSE)

Tạo UUID ngẫu nhiên.

Input:

{}

Output:

Generated UUID: 123e4567-e89b-12d3-a456-426614174000

Resources (Tài nguyên)

info://server

Thông tin về MCP server.

data://example

Dữ liệu JSON ví dụ.

stats://connections (chỉ SSE)

Thống kê kết nối.

Cấu trúc dự án

mcp-playground/
├── src/
│   ├── index.ts          # Stdio transport server
│   └── sse-server.ts     # SSE transport server
├── dist/                 # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md

Development

# Build project
npm run build

# Watch mode (auto rebuild)
npm run watch

# Run stdio server in dev mode
npm run dev

# Run SSE server in dev mode
npm run dev:sse

Kiểm thử

Test Stdio Transport

# Chạy server
npm run dev

# Gửi JSON-RPC request qua stdin (trong terminal khác)
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npm run dev

Test SSE Transport

# Chạy server
npm run dev:sse

# Test health endpoint
curl http://localhost:3000/health

# Test SSE endpoint (trong browser hoặc với curl)
curl -N http://localhost:3000/sse

Tài liệu tham khảo

License

MIT

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • Echo MCP Server

    somacaru
    F
    license
    Not graded
    quality
    D
    maintenance
    A simple demonstration MCP server that provides an echo tool and resource for learning how to build MCP servers. Serves as a starting point and template for creating custom MCP server implementations.
    1
    -

  • Mock MCP Server

    DiscreteTom
    A
    license
    B
    quality
    D
    maintenance
    A mock MCP server for testing MCP client implementations and development workflows. Supports tools, prompts, and resources across multiple transport protocols (stdio, HTTP, SSE).
    1
    MIT