______________________________________________________________________
标题:谋杀之谜MCP服务器 表情符号🕵️ 颜色来源:靛蓝 颜色:红色 sdk:毕业 sdk版本:“5.29.1” app_file:demo.py 固定:false 标签:
- 打造mcp轨道创意
- 主控程序
- mcp服务器
- 游戏引擎
- 谋杀之谜
- 代理
- 工具
- 资源
______________________________________________________________________
🕵️ 谋杀之谜MCP服务器
🎉 MCP 1岁生日黑客马拉松 --轨道1:构建MCP(building-mcp-track-creative)A完整 谋杀悬疑游戏引擎 作为模型上下文协议(MCP)服务器公开。生成程序谜团、审问人工智能嫌疑人、寻找线索和破案——所有这些都是通过任何人工智能代理都可以使用的MCP工具完成的。
______________________________________________________________________
📺 演示视频
👉 观看演示视频 *(必须提交)*
______________________________________________________________________
🐦 社交媒体
🐦 查看X/Twitter上的公告 *(必须提交)*
______________________________________________________________________
👥 团队
|HuggingFace用户名| |---------------------| |@YOUR_HF.USERNAME|
______________________________________________________________________
🚀 快速开始
与Claude Desktop一起使用
添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"murder-mystery": {
"command": "python",
"args": ["-m", "murder_mystery_mcp"],
"cwd": "/path/to/murder-mystery-mcp",
"env": {
"OPENAI_API_KEY": "your-key",
"HF_TOKEN": "your-hf-token",
"ELEVENLABS_API_KEY": "your-elevenlabs-key"
}
}
}
}那就和克劳德聊聊吧:
- *“开始一个新的谋杀神秘游戏”*
- *“跟管家谈谈他的不在场证明”*
- *“在图书馆寻找线索”*
- *“我指控阿什沃斯夫人谋杀!”*
与光标一起使用
将相同的配置添加到Cursor的MCP设置中,并使用AI聊天中的工具。
______________________________________________________________________
🛠️ MCP工具
游戏流程工具
| 工具 | 说明 |
|---|---|
start_game | 开始一个新的程序生成的谋杀之谜 |
get_game_state | 获取当前游戏状态(嫌疑人、线索、进度) |
interrogate_suspect | 询问嫌疑人(他们有记忆+情绪!) |
search_location | 在某个地点寻找线索 |
make_accusation | 正式指控某人谋杀 |
调查工具(RAG供电)
| 工具 | 说明 |
|---|---|
search_memory | 在所有过去的对话中搜索相关陈述 |
find_contradictions | 检查嫌疑人的故事是否与过去的陈述相矛盾 |
get_cross_references | 查找其他嫌疑人对某人的评价 |
get_investigation_hint | 如果你被困住了,就得到提示 |
get_timeline | 查看调查时间表 |
图像生成工具
| 工具 | 说明 |
|---|---|
generate_portrait | 生成嫌疑人的肖像 |
generate_scene | 生成位置/场景图像 |
generate_title_card | 生成神秘的开场场景 |
______________________________________________________________________
📚 MCP资源
| URI | 描述 |
|---|---|
mystery://state | 当前游戏状态(JSON) |
mystery://suspects | 有公开信息的嫌疑人名单 |
mystery://clues | 发现线索 |
mystery://timeline | 调查时间表 |
mystery://locations | 可用和搜索的位置 |
______________________________________________________________________
🎮 运作原理
1.神秘一代
当你开始游戏时,服务器会生成:
- 一个有背景故事的独特受害者
- 4-5名有个性、秘密和不在场证明的嫌疑人
- 一个有罪的嫌疑人(人工智能不会告诉你是谁!)
- 线索分散在各个地点
- 一张“相遇图”,显示谁真正在哪里
2.Oracle模式
MCP服务器使用 安全的“Oracle”架构:
- 这 神秘先知 知道真相(谁有罪,所有的秘密)
- 这 工具 只返回玩家应该看到的内容
- 即使是使用这些工具的人工智能也不能“作弊”——它通过游戏发现真相
3.可疑情绪
嫌疑人不是静止的,他们有:
- 信任 (0-100%):他们有多信任侦探
- 紧张 (0-100%):他们有多焦虑
- 记忆:他们能记住过去的对话并保持一致
- 揭示:高度信任→ 显示位置;高压→ 揭露秘密
4.RAG存储器
所有对话都在向量存储中索引:
- 搜索关于任何主题的内容
- 发现证词中的矛盾
- 交叉引用嫌疑人对彼此的评价
______________________________________________________________________
🏗️ 建筑
┌──────────────────────────────────────────────────────────────────┐
│ MURDER MYSTERY MCP SERVER │
├──────────────────────────────────────────────────────────────────┤
│ │
│ TOOLS (what agents can call): │
│ ├─ start_game - Generate new mystery │
│ ├─ interrogate_suspect - Talk to suspects │
│ ├─ search_location - Find clues │
│ ├─ make_accusation - Accuse the murderer │
│ ├─ search_memory - RAG search past statements │
│ ├─ find_contradictions - Detect lies │
│ ├─ get_cross_references- What others said about someone │
│ ├─ generate_portrait - Create character art │
│ └─ generate_scene - Create location art │
│ │
│ RESOURCES (what agents can read): │
│ ├─ mystery://state - Full game state │
│ ├─ mystery://suspects - Suspect list │
│ ├─ mystery://clues - Discovered clues │
│ └─ mystery://timeline - Investigation timeline │
│ │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ MYSTERY ORACLE (truth) │ │
│ │ • Knows who the murderer is │ │
│ │ • Knows all suspects' secrets │ │
│ │ • Validates accusations │ │
│ │ • Generates consistent suspect responses │ │
│ │ • NEVER exposes truth to the agent directly │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ RAG MEMORY (partitioned) │ │
│ │ • Per-suspect conversation history │ │
│ │ • Semantic search across all statements │ │
│ │ • Contradiction detection │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ │
└──────────────────────────────────────────────────────────────────┘______________________________________________________________________
⚙️ 配置
| 环境变量 | 必填 | 说明 |
|---|---|---|
OPENAI_API_KEY | 是 | 用于神秘生成和LLM回复 |
HF_TOKEN | 否 | 用于图像生成(可选) |
ELEVENLABS_API_KEY | 否 | 用于语音合成(可选,由UI使用) |
______________________________________________________________________
🎯 游戏规则
- 3个错误指控=游戏结束 (你被开除了)
- 赢:用证据正确辨认凶手
- 嫌疑人不会轻易泄露秘密——建立信任或施加压力!
- 线索隐藏在各个位置——到处搜索
- 交叉引用证词以发现矛盾
______________________________________________________________________
🔗 相关项目
- 谋杀神秘侦探游戏 --使用此MCP服务器的完整Gradio UI(Track 2提交)
______________________________________________________________________
📜 许可证
麻省理工学院
