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

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

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Related Resources

Need Help?

Report Issue

MCP Playground

MCP Playground

Tính năng

Cài đặt

Sử dụng

1. Stdio Transport (Pure MCP SDK)

Cấu hình cho Claude Desktop

2. SSE Transport (Server-Sent Events)

Kết nối với SSE Client

API

Tools (Công cụ)

`echo`

`add`

`get_time`

`generate_uuid` (chỉ SSE)

Resources (Tài nguyên)

`info://server`

`data://example`

`stats://connections` (chỉ SSE)

Cấu trúc dự án

Development

Kiểm thử

Test Stdio Transport

Test SSE Transport

Tài liệu tham khảo

License

Related Resources

New MCP Servers

MCP directory API

MCP Playground

Tính năng

Cài đặt

Sử dụng

1. Stdio Transport (Pure MCP SDK)

Cấu hình cho Claude Desktop

2. SSE Transport (Server-Sent Events)

Kết nối với SSE Client

API

Tools (Công cụ)

echo

add

get_time

generate_uuid (chỉ SSE)

Resources (Tài nguyên)

info://server

data://example

stats://connections (chỉ SSE)

Cấu trúc dự án

Development

Kiểm thử

Test Stdio Transport

Test SSE Transport

Tài liệu tham khảo

License

Related Resources

New MCP Servers

MCP directory API

`echo`

`add`

`get_time`

`generate_uuid` (chỉ SSE)

`info://server`

`data://example`

`stats://connections` (chỉ SSE)