使用说明

项目简介

'weather-server MCP Server' 是一个基于 Model Context Protocol (MCP) 的服务器，它演示了 MCP 的核心概念，通过提供 Dungeons & Dragons (D&D) 怪兽数据作为资源，并提供工具来检索这些怪兽信息。该服务器允许 LLM 客户端通过标准化的 MCP 协议访问和利用 D&D 怪兽数据。

主要功能点

资源访问 (Resources): 虽然代码中没有明确定义资源 URI，但服务器核心功能是提供对 D&D 怪兽数据的访问，可以理解为一种资源服务。
工具调用 (Tools):
- 'get_monster': 根据怪兽名称检索并返回详细的怪兽数据。
- 'find_similar_monsters': 根据输入的怪兽名称，查找并返回相似的怪兽列表。

安装步骤

环境准备: 确保已安装 Node.js 和 npm (或 pnpm)。
下载代码: 克隆 GitHub 仓库 'https://github.com/jherr/datastax-mcp-monsters' 到本地。
进入目录: 使用命令行工具进入克隆到本地的仓库目录。
安装依赖: 运行命令 'npm install' 或 'pnpm install' 安装项目依赖。
构建项目: 运行命令 'npm run build' 或 'pnpm run build' 构建服务器代码。
配置 Astra DB:
- 你需要一个 Datastax Astra DB 数据库来存储怪兽数据。如果你还没有，请前往 Datastax Astra DB 注册并创建一个数据库。
- 在 Astra DB 控制台中，创建一个新的数据库，并获取 API Endpoint 和 Application Token。
- 运行 'pnpm install' 安装数据加载脚本依赖。
- 编辑 'scripts/load.ts' 文件，将 'CLIENT_ID' 替换为你的 Astra DB 客户端 ID (如果需要)，将 'API_ENDPOINT' 替换为你的 Astra DB API Endpoint，然后运行 'pnpm ts-node scripts/load.ts' 加载 'monsters.json' 中的数据到你的 Astra DB 数据库中。 请注意，你可能需要先配置正确的 Astra DB 客户端 ID 和 API Endpoint 才能成功运行数据加载脚本。

服务器配置

要将此 MCP 服务器配置到 MCP 客户端（例如 Claude 桌面应用），你需要提供服务器的启动配置信息。以下是一个 'claude_desktop_config.json' 文件的配置示例，你需要根据你的实际环境进行调整。请注意，MCP 客户端通常需要这个 JSON 配置来连接到 MCP 服务器，用户无需手动运行 'node' 命令。

{
  "mcpServers": {
    "monster-server": {
      "name": "monster-server",  // 服务器名称，客户端显示用，可以自定义
      "command": "[Node.js 可执行文件路径]", // Node.js 可执行文件的路径，例如：/usr/bin/node 或 C:\\Program Files\\nodejs\\node.exe
      "args": ["[仓库路径]/build/index.js"], // 服务器启动脚本路径，指向构建后的 index.js 文件
      "env": {
        "ASTRA_DB_API_ENDPOINT": "你的 Astra DB API Endpoint", //  你的 Astra DB API Endpoint，从 Astra DB 控制台获取
        "ASTRA_DB_APPLICATION_TOKEN": "你的 Astra DB Application Token" // 你的 Astra DB Application Token，从 Astra DB 控制台获取
      }
    }
  }
}

请将 '[Node.js 可执行文件路径]' 替换为你的 Node.js 可执行文件的实际路径。
请将 '[仓库路径]' 替换为此仓库在你的本地文件系统中的实际路径。
请将 '你的 Astra DB API Endpoint' 和 '你的 Astra DB Application Token' 替换为你在 Astra DB 控制台中获取的实际值。

基本使用方法

确保已按照 服务器配置 中的说明，在 MCP 客户端中正确配置了 'monster-server'。
启动 MCP 客户端应用程序（例如 Claude 桌面应用）。客户端会自动尝试连接到配置的 MCP 服务器。
在 MCP 客户端中，你可以指示 LLM 调用 'get_monster' 或 'find_similar_monsters' 工具，并提供怪兽名称作为参数。服务器将处理请求并返回怪兽数据。具体的工具调用方式取决于 MCP 客户端的界面和指令格式。

关键词