Skip to main content
Glama
etfromchina

MCP Riddle Game Server

by etfromchina

MCP Riddle Game Server

一个基于 Starlette 的 MCP 猜谜游戏服务,支持 HTTP POSTSSE 两种通信方式。

功能

  • 提供 4 个 MCP 工具:

    • get_riddle_random:获取谜语(random / sequential / category

    • get_riddle_answer:校验答案

    • list_categories:列出分类

    • get_riddle_count:谜语统计

  • 支持从 riddles.json 加载数据

  • 可通过环境变量 RIDDLES_JSON 覆盖谜语库

项目结构

mcp-riddle/
├── server_sse.py
├── riddles.json
├── requirements.txt
├── Dockerfile
├── DEPLOY.md
└── README.md

本地运行

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python server_sse.py

启动后默认监听 0.0.0.0:8000

接口

  • SSE: GET /sse

  • MCP 消息: POST /messages

  • 健康检查: GET /health

兼容端点(用于部分第三方 Agent):

  • GET /mcp(SSE 别名)

  • POST /sse(部分平台会对同一路径发消息)

  • POST /sse/messages(SSE 消息别名)

  • POST /mcp(单路径兼容)

健康检查示例

curl http://127.0.0.1:8000/health

HTTP 模式调用示例

curl -X POST http://127.0.0.1:8000/messages \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
curl -X POST http://127.0.0.1:8000/messages \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_riddle_random","arguments":{"mode":"sequential"}}}'

Docker

docker build -t mcp-riddle .
docker run -d --name mcp-riddle-server -p 48080:8000 --restart always mcp-riddle
curl http://127.0.0.1:48080/health

AI Agent 接入

SSE 方式

{
  "mcpServers": {
    "riddle-game": {
      "url": "http://<server-ip>:48080/sse",
      "transport": "sse"
    }
  }
}

如果平台只允许填一个端点路径,优先使用 /mcp

HTTP 方式

{
  "mcpServers": {
    "riddle-game": {
      "url": "http://<server-ip>:48080/messages",
      "transport": "http"
    }
  }
}
-
security - not tested
F
license - not found
-
quality - not tested

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/etfromchina/mcp-riddle'

If you have feedback or need assistance with the MCP directory API, please join our Discord server