MCP Lottery Demo

# 安装和运行指南 ## 快速开始 ### 1. 安装依赖 ```bash npm install ``` ### 2. 运行 MCP 服务器 ```bash npm start ``` ### 3. 测试工具功能 ```bash node test-client.js --test ``` ## 详细说明 ### 项目结构 ``` mcp-lottery-demo/ ├── package.json # 项目配置 ├── README.md # 项目说明 ├── demo-prompts.md # 演示 prompt 集合 ├── test-client.js # 测试客户端 ├── .gitignore # Git 忽略文件 └── src/ └── server.js # MCP 服务器实现 ``` ### 开发模式 ```bash npm run dev ``` 这会启动监视模式，代码修改后自动重启服务器。 ### 交互式测试 ```bash node test-client.js ``` 进入交互式模式后，你可以使用以下命令： - `test` - 运行自动测试 - `lottery 选项1,选项2,选项3` - 抽签 - `dice 面数 数量` - 投骰子 - `coin 次数` - 抛硬币 - `quit` - 退出 ### 示例命令 ```bash # 抽签 lottery 苹果,香蕉,橙子,葡萄 # 投骰子 dice 20 3 # 抛硬币 coin 5 ``` ## 与 AI 助手集成 ### 配置 MCP 客户端 如果你使用的是支持 MCP 的 AI 客户端（如 Claude Desktop），可以在配置文件中添加： ```json { "mcpServers": { "lottery-tool": { "command": "node", "args": ["D:/代码存储/McpDemo/src/server.js"], "cwd": "D:/代码存储/McpDemo" } } } ``` ### 使用示例 配置完成后，你可以直接与 AI 助手对话： ``` 帮我从这些水果中随机选一个：苹果、香蕉、橙子、葡萄、草莓 ``` AI 助手会自动调用 MCP 工具并返回结果。 ## 故障排除 ### 常见问题 1. **依赖安装失败** ```bash npm cache clean --force npm install ``` 2. **权限问题** ```bash chmod +x src/server.js ``` 3. **端口冲突** 检查是否有其他进程占用了标准输入输出 ### 调试模式 ```bash DEBUG=* node src/server.js ``` ## 扩展开发 ### 添加新工具 1. 在 `tools` 数组中添加新工具定义 2. 在 `CallToolRequestSchema` 处理器中添加对应的 case 3. 实现工具逻辑 ### 自定义功能 - 修改随机算法 - 添加更多参数选项 - 实现结果持久化 - 添加统计分析功能 ## 许可证 MIT License