关键词

宝可梦数据资源服务工具调用LLM集成上下文服务

使用说明

项目简介

本项目 'mcp-server' 是一个基于 Model Context Protocol (MCP) 的服务器示例，它模拟了一个提供宝可梦信息的服务。该服务器通过 MCP 协议与客户端通信，提供宝可梦资源和工具，演示了如何构建一个简单的 MCP 后端应用。

主要功能点

  • 资源 (Resources): 提供宝可梦数据作为资源，可以通过 'pokemon://{pokemon_id}' 格式的 URI 访问，例如 'pokemon://pikachu'。每个宝可梦资源包含名称、类型、描述和统计信息。
  • 工具 (Tools): 实现了一个名为 'get_stats' 的工具，允许客户端查询特定宝可梦的详细统计信息。

安装步骤

  1. 克隆仓库: 首先，你需要克隆 'mcp-server' 仓库到本地： 
    git clone https://github.com/AI-FOR-DEVS/mcp-server.git
cd mcp-server
  2. 安装依赖 (可选): 虽然仓库中没有明确的依赖安装步骤，但根据 'README.md' 中的 'uv sync' 和 'uv build' 命令，以及 Python 代码，你可能需要安装 'uv' (uvloop) 包管理器。如果你的环境中没有 'uv'，可以尝试使用 'pip' 安装 'uvloop' 和 'mcp' 库。 
    # 如果你使用 pip
pip install uvloop mcp
# 如果你使用 uv (根据 README 建议)
uv sync

服务器配置

要将此 MCP 服务器配置到 MCP 客户端（例如 Claude Desktop），你需要提供服务器的启动命令和参数。以下是基于 'README.md' 提供的配置信息，你需要根据你的实际环境进行调整：

Claude Desktop 配置示例 (Development/Unpublished Servers Configuration):

将以下 JSON 配置添加到 Claude Desktop 的配置文件 ('claude_desktop_config.json') 中。你需要根据你的实际 'mcp-server' 仓库路径修改 'args' 中的目录路径。

{
  "mcpServers": {
    "pokemon-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/mcp-server",  // 替换为你的 mcp-server 仓库的绝对路径，例如 "/Users/yourname/mcp-server"
        "run",
        "pokemon-server"
      ]
    }
  }
}

注意: 请将 '/path/to/your/mcp-server' 替换为你克隆的 'mcp-server' 仓库在你的电脑上的实际路径。这个配置使用了 'uv' 命令来运行服务器，这与 'README.md' 中的开发配置一致。

基本使用方法

  1. 启动 MCP 客户端: 配置完成后，启动你的 MCP 客户端（例如 Claude Desktop）。客户端应该会根据配置自动启动 'pokemon-server'。
  2. 与 LLM 交互: 在 MCP 客户端中，你可以指示 LLM 使用 'pokemon-server' 提供的功能。具体的交互方式取决于 MCP 客户端的功能。例如，你可以要求 LLM 查找关于 "pikachu" 的信息，客户端可能会利用 'pokemon://pikachu' 资源来获取信息，或者调用 'get_stats' 工具来获取宝可梦统计数据。

调试: 如果需要调试 MCP 服务器，可以使用 'README.md' 中提到的 MCP Inspector 工具。

npx @modelcontextprotocol/inspector uv --directory /path/to/your/mcp-server run pokemon-server

同样，请替换 '/path/to/your/mcp-server' 为你的实际仓库路径。

信息

分类

开发者工具

访问项目