使用说明
魔术8球MCP服务器
演示 模型上下文协议 实现经典魔术8球预言机的服务器。使用TypeScript和 包子.
里面有什么
| MCP图元 | 名称 | 描述 |
|---|---|---|
| 工具 | shake |
问一个是/否的问题，得到一个随机的8球答案 |
| 提示 | ask-the-8-ball |
用于查询oracle的可重用提示模板 |
| 资源 | magic-8-ball://responses |
20个经典答案的完整列表 |
先决条件
入门指南
# Install dependencies
bun install
# Run the server directly (stdio transport)
bun run start
MCP检验员测试
这 MCP检查员 提供用于与服务器交互的浏览器UI。
bun run inspect
这将打开http://localhost:6274您可以在哪里：
- 工具 --呼叫
shake带着一个问题，看看随机的8球答案 - 提示 --拿到
ask-the-8-ball填写问题的提示模板 - 资源 --阅读
magic-8-ball://responses查看全部20个经典答案
Claude Desktop的构建和封装
1.建造
将TypeScript编译为JavaScript，以便该包可以与Node.js（随Claude Desktop附带）一起运行：
bun run build
这创造了 dist/index.js --包含所有依赖项的单个文件包。
2.创建清单
如果还没有，请初始化MCPB清单：
bunx @anthropic-ai/mcpb init
A. manifest.json 已包含在此仓库中。您可以验证它：
bunx @anthropic-ai/mcpb validate manifest.json
3.包装
bunx @anthropic-ai/mcpb pack .
这创建了一个 .mcpb 文件（例如。， magic-8-ball-mcp-1.0.0.mcpb).
4.安装在克劳德桌面
双击 .mcpb 文件（或使用Claude Desktop打开）。Claude将显示一个安装对话框--单击 安装 魔术8球工具将在您的对话中提供。
项目结构
bun-demo-mcp/
├── .claude/
│ └── CLAUDE.md # Claude Code project instructions
├── dist/
│ └── index.js # Compiled bundle (generated)
├── src/
│ ├── index.ts # MCP server (tool + prompt + resource)
│ └── responses.ts
├── bun.lock
├── manifest.json # MCPB bundle manifest
├── package.json
├── README.md
└── tsconfig.json
许可证
麻省理工学院
