使用说明

项目简介

本项目是一个基于Model Context Protocol (MCP) 的服务器实现,旨在为LLM(大型语言模型)客户端提供上下文信息和工具能力。目前,该服务器实现了一个简单的天气预报工具,可以根据用户提供的经纬度查询当地的天气信息。

主要功能点

  • 天气预报工具: 提供查询天气预报的功能,LLM可以通过调用此工具获取指定位置的天气信息。
  • MCP协议支持: 遵循MCP协议规范,可以与任何支持MCP协议的LLM客户端(如Claude Desktop)进行交互。
  • JSON-RPC通信: 使用JSON-RPC协议与客户端进行通信,实现请求和响应的标准化。

安装步骤

  1. 安装Node.js 和 npm: 确保你的电脑上已经安装了Node.js和npm(Node.js包管理器)。你可以从 https://nodejs.org/ 下载并安装。

  2. 下载仓库代码: 从 https://github.com/MCP-Mirror/Alesion30_my-mcp-server 下载仓库代码到本地。

  3. 安装依赖: 在仓库根目录下,打开终端并执行以下命令安装项目依赖:

    npm install
  4. 构建项目: 执行以下命令构建项目,生成可执行的JavaScript文件:

    npm run build

    构建成功后,会在项目根目录下生成 'build' 文件夹,可执行文件 'main.js' 位于 'build' 文件夹内。

服务器配置

要将此MCP服务器配置到MCP客户端(例如 Claude Desktop),你需要提供服务器的启动命令和参数。以下是针对 Claude Desktop 的配置示例,你需要根据你的实际环境进行调整。

在 Claude Desktop 的配置文件 'claude_desktop_config.json' 中 (macOS 路径: '~/Library/Application\ Support/Claude/claude_desktop_config.json'),添加或修改 'mcpServers' 配置项,加入以下server配置:

{
  "mcpServers": {
    "myMcp": {
      "command": "node",
      "args": ["/path/to/your/my-mcp-server/build/main.js"]
    }
  }
}

配置参数说明:

  • '"myMcp"': 服务器名称,可以自定义,用于在客户端中标识该服务器。
  • '"command": "node"': 启动服务器的命令,这里使用 'node' 命令来运行JavaScript文件。请确保 'node' 命令在你的系统环境变量 'PATH' 中,或者提供 'node' 的完整路径 (例如: '/usr/local/bin/node')。 你可以使用命令 'which node' 查找 'node' 的完整路径。
  • '"args": ["/path/to/your/my-mcp-server/build/main.js"]': 传递给 'node' 命令的参数,这里指定了服务器入口文件 'main.js' 的路径。 请将 '/path/to/your/my-mcp-server/build/main.js' 替换为你本地 'my-mcp-server' 仓库中 'build/main.js' 文件的绝对路径**。** 你可以使用 'find 'pwd' -maxdepth 2 -name main.js' 命令在项目根目录下查找 'main.js' 的完整路径。

配置完成后,重启 Claude Desktop 客户端,客户端应该就能检测到并连接到你的 MCP 服务器了。

基本使用方法

配置并启动 MCP 服务器后,在 Claude Desktop 中,你可以尝试询问天气相关的问题,例如:

サンフランシスコの天気は? (旧金山的天气怎么样?)

如果 MCP 服务器配置正确,Claude 应该能够调用天气预报工具,并结合天气信息给出回答。 你可以根据 README.md 中提供的图片示例进行效果验证。

注意: 该天气预报工具目前仅支持美国地区的天气查询,使用的天气数据来源于美国国家气象局 (National Weather Service)。

信息

分类

网页与API