项目简介

这是一个包含两个独立 MCP（Model Context Protocol）服务器实现的仓库。它们使用 '@modelcontextprotocol/sdk' 开发，并通过标准的 'stdin'/'stdout' 传输方式与兼容 MCP 的 AI 客户端进行通信。

主要功能点

1. OnePieceServer:
   • 功能: 允许查询日本动漫/漫画《One Piece》（海贼王）的角色信息。
   • 用法: 可以通过角色的特定 ID 查询单个角色信息，或查询所有可用角色列表。
   • 工具名称: 'one_piece'
2. Geolocalizar:
   • 功能: 允许根据公共 IPv4 地址查询其近似的地理位置信息。
   • 用法: 提供一个有效的 IPv4 地址作为输入，服务器将返回相关的地理位置数据。
   • 工具名称: 'geolocalizar'

安装步骤

1. 确保环境: 需要安装 Node.js (版本 ≥ 18) 和 npm (版本 ≥ 9)。

2. 下载代码: 克隆或下载本仓库的代码。

3. 安装依赖: 在项目根目录运行以下命令安装所需的依赖库（包括 MCP SDK、用于网络请求的 axios、用于数据验证的 zod 以及用于直接运行 TypeScript 的 tsx）：

   npm install @modelcontextprotocol/sdk axios zod tsx
   

服务器配置（供 MCP 客户端使用）

MCP 客户端需要知道如何启动这些服务器进程。通常，客户端需要配置服务器的名称 (name)、启动命令 (command) 和启动参数 (args)。

• 配置 OnePieceServer:

  • 服务器名称 (name): 'OnePieceServer'
  • 启动命令 (command): 'npx'
  • 启动参数 (args): '["tsx", "onePiece.ts"]'

• 配置 Geolocalizar:

  • 服务器名称 (name): 'Geolocalizar'
  • 启动命令 (command): 'npx'
  • 启动参数 (args): '["tsx", "geolocalizar.ts"]'

客户端将使用这些信息启动相应的服务器进程，并通过 'stdin'/'stdout' 进行 MCP 协议通信。

基本使用方法

这些服务器是为 MCP 兼容的 AI 客户端设计的后端服务。您无需直接与服务器的命令行界面交互。正确配置后，客户端将能够：

1. 检测到服务器暴露的能力（例如 'one_piece' 和 'geolocalizar' 工具）。
2. 根据用户的请求，向服务器发送 JSON-RPC 请求来调用特定的工具。
3. 服务器接收请求，执行相应的逻辑（如调用外部 API），并将结果通过 JSON-RPC 响应返回给客户端。

例如，客户端可能会向 OnePieceServer 发送调用 'one_piece' 工具的请求，输入 '{ "id": "todos" }' 来获取所有角色列表；或者向 Geolocalizar 发送调用 'geolocalizar' 工具的请求，输入 '{ "ip": "8.8.8.8" }' 来查询 IP 地址信息。