A Model Context Protocol (MCP) Streamable HTTP server supporting auto-generated CRUD tools of database with Authorization and credential Authentication.
- MCP Streamable HTTP Protocol: Multiple simultaneous MCP server connections with credential Authentication support.
- ZenStack Integration: Automatically generates MCP tools for the CRUD operations of the models defined in the ZenStack schema. This demo will use a simple blog application with
User
andPost
models.
The server automatically generates MCP tools for each model defined in the ZenStack schema. Here are the supported tools:
- findUnique
- findFirst
- findMany
- create
- createMany
- delete
- deleteMany
- update
- updateMany
- upsert
- aggregate
- groupBy
- count
You can opt-in available tools for functionNames
variable in mcp-server.ts
-
Install dependencies:
npm install
-
Set up the database:
npx zenstack generate npx prisma db push
-
Seed the database (optional):
npx prisma db seed
It create 3 users with posts. The passwords for all users are
password123
. -
Start the server:
npm run dev
The easiest way to test the MCP server is to run
npx @modelcontextprotocol/inspector
If your chosen MCP client supports remote OAuth2 MCP server, you can directly connect. Otherwise, you can use mcp-remote
to do it
All the most popular MCP clients (Claude Desktop, Cursor, Github Copilot) use the following config format:
{
"servers": {
"my-mcp-server": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:3001/mcp"]
}
}
}
If you encounter an invalid client
error when connecting to the MCP server, it may be due to that mcp-remote
only register oauth client for the first time.you can fix it by removing the cached client state:
rm -rf ~/.mcp-auth
When using Claude Desktop, if you didn't see any OAuth window open in your browser, it may be due to the fact that Claude Desktop is using an old version of Node.js even if you have a newer version installed. You can fix it by deleting old versions of Node.js in NVM.