龙珠数据服务

DBZ MCP服务器-POC

模型上下文协议（MCP）服务器，通过龙珠API提供对龙珠Z宇宙数据的访问。

作者

奥利维拉·古斯塔沃 (@奥利维拉·古斯塔沃01)

这有什么作用

它提供：

• 角色搜索：查找有关龙珠角色的详细信息，包括他们的属性、种族、隶属关系和力量级别
• 行星搜索：探索龙珠行星及其当前状态
• 转型搜索：查找龙珠变换及其力量级别
• 资源访问：通过MCP资源浏览所有可用角色和行星

TechStack

• TypeScript -主要编程语言
• Node.js -运行时环境
• 模型上下文协议SDK -MCP服务器实现
• 阿西奥斯 -API请求的HTTP客户端
• 黄道 -模式验证和类型安全
• 快速 -Web框架（依赖关系）
• 龙珠API -外部数据源(https://dragonball-api.com/api)

先决条件

• Node.js （v16或更高版本）
• npm （附带Node.js）

安装和设置

1. 克隆或下载项目 （如果尚未完成）

2. 安装依赖项:

   复制

   npm install
   

3. 构建项目:

   复制

   npm run build
   

MCP检验员测试

# Use the MCP inspector to test the server
npm run inspector

可用工具

服务器提供三个主要工具：

1.搜索字符

• 工具ID: search_characters
• 描述：按名称搜索龙珠角色

2.搜索行星

• 工具ID: search_planets
• 描述：按名称搜索龙珠行星

3.搜索转换

• 工具ID: search_transformations
• 描述：按名称搜索龙珠变换

可用资源

• 所有字符 (dbz://characters)-访问所有龙珠角色
• 所有行星 (dbz://planets)-进入所有龙珠星球

🔌 与MCP客户端一起使用

示例配置（克劳德桌面）

{
  "mcpServers": {
    "dbz-mcp-server": {
      "command": "node",
      "args": ["path/to/dbz-mcp-server/build/index.js"]
    }
  }
}

示例配置（VSCode副驾驶）

1. 创建.vcode目录
2. 创建一个“mcp.json”文件

{
  "mcpServers": {
    "dbz-mcp-server": {
      "command": "node",
      "args": ["path/to/dbz-mcp-server/build/index.js"]
    }
  }
}

项目结构

dbz-mcp-server/
├── src/
│   ├── index.ts          # Main server implementation
│   └── types.ts          # TypeScript type definitions
├── build/                # Compiled JavaScript output
├── package.json          # Project dependencies and scripts
├── tsconfig.json         # TypeScript configuration
└── README.md            # Project documentation

🔗 外部依赖

• 龙珠API -提供龙珠宇宙数据
• 模型上下文协议 -人工智能助手的通信标准

备注：本项目用于研究和开发目的。Dragon Ball API URL目前是硬编码的，但理想情况下应设置为生产环境中的环境变量。