Demo MCP Server

What is Demo MCP Server?

Demo MCP Server is a demo blocklet that hosts an MCP (Model Context Protocol) server. It is a full-stack dapp application containing both server and client code, bootstrapped with Create Blocklet and using the @blocklet/mcp package for authentication and authorization.

How to use Demo MCP Server?

Enable the blocklet as an MCP server by setting blocklet.yml#capabilities.mcp to true. Then configure the MCP server in api/src/mcp/server.ts, set up SSE transport in api/src/mcp/sse.ts with endpoint /mcp/sse, and attach the server to the app in api/src/index.ts. For debugging, use the provided debug blocklet URL.

Key features of Demo MCP Server

• Hosts a full MCP server within a Blocklet.
• Uses @blocklet/mcp for authentication and authorization.
• Supports SSE transport at the /mcp/sse endpoint.
• Includes a separate debug tool for testing.
• Licensed under Apache 2.0.

Use cases of Demo MCP Server

• Demo and test an MCP server implementation inside a Blocklet.
• Prototype MCP-based applications with built-in auth.
• Debug and validate MCP endpoints using the provided debug blocklet.

FAQ from Demo MCP Server

What is the purpose of Demo MCP Server?

It is a demo blocklet that hosts an MCP server, intended for testing and prototyping MCP integrations within the Blocklet ecosystem.

What are the runtime requirements?

Node.js version 20.14.0 or higher, and Server version 1.16.28 or higher.

How does authentication work?

The server uses the @blocklet/mcp package to handle authentication and authorization.

What transport does the MCP server use?

It uses SSE (Server-Sent Events) with the endpoint set to /mcp/sse.

Is there a way to debug the MCP server?

Yes, you can use the debug blocklet at https://dev.store.blocklet.dev/blocklets/z2qZwzdTFvPFN275o7wm4WwXTAVBvdSfHSDqq.