关键词

时间服务日本时间MCP示例工具调用Cline

使用说明

项目简介

本项目 'cline-mcp-server-sample' 是一个基于 Model Context Protocol (MCP) 的服务器示例，它实现了一个简单的工具，可以返回日本当前时间。该示例旨在帮助开发者理解 MCP 服务器的基本结构和运行方式，并演示如何通过 MCP 协议向客户端提供工具功能。

主要功能点

  • 提供日本时间查询工具: 服务器注册了一个名为 'get-current-time' 的工具，客户端可以调用此工具获取日本当前时间的字符串。
  • 基于 MCP 协议: 服务器使用 '@modelcontextprotocol/sdk' 库构建，遵循 MCP 协议规范，能够与任何兼容 MCP 协议的客户端进行通信。
  • 使用 Stdio 传输: 服务器采用 Stdio (标准输入输出) 作为传输协议，简化了部署和运行方式。

安装步骤

  1. 安装 Bun: 如果尚未安装 Bun，请先安装 Bun。根据 Bun 官网的指引进行安装。
  2. 安装依赖: 克隆仓库到本地后，在项目根目录下运行以下命令安装项目依赖： 
    bun install

服务器配置

MCP 服务器需要配置到 MCP 客户端中才能使用。以 Cline 客户端为例，需要在 Cline 的 MCP 服务器配置文件 '~/.vscode-server/data/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json' 中添加如下配置信息。

{
  "mcpServers": {
    "example-server": { // 服务器名称，可以自定义，在 Cline 客户端中用于标识该服务器
      "command": "/root/.bun/bin/bun",  // Bun 可执行文件的完整路径，请根据你的 Bun 安装路径修改
      "args": ["run", "/workspace/mcp-server/index.ts"],  // 启动服务器的命令参数，指向 index.ts 文件的完整路径，请根据你的项目路径修改
      "env": {} // 环境变量，本示例中为空
    }
  }
}

注意:

  • 请将 'command' 和 'args' 中的路径替换为你实际的 Bun 可执行文件路径和 'index.ts' 文件路径。
  • 如果你不熟悉 Linux 路径，可以将 '/root/.bun/bin/bun' 替换为 'which bun' 命令的输出结果，将 '/workspace/mcp-server/index.ts' 替换为 'pwd'/index.ts (在你的项目根目录下执行 'pwd' 命令获取当前路径)。
  • 确保 Cline 客户端能够访问到 'command' 指定的 Bun 可执行文件，以及 'args' 指定的 'index.ts' 文件。

基本使用方法

  1. 启动服务器: 在项目根目录下运行以下命令启动 MCP 服务器： 
    bun run index.ts
    启动成功后，终端会输出 "時間表示MCPサーバーが正常に起動しました。" (时间显示MCP服务器已成功启动。)。
  2. 在 Cline 客户端中启用服务器:
    • 打开 VSCode，并确保已安装 Cline 扩展。
    • 打开命令面板 (Ctrl+Shift+P 或 Cmd+Shift+P)。
    • 搜索 "Cline: Refresh MCP Servers" 并执行该命令。
    • Cline 客户端会尝试连接并启用在配置文件中注册的 MCP 服务器。
    • 检查 Cline 状态栏，确认 "example-server" 服务器是否已成功连接并运行。
  3. 在 Cline 中调用工具: 在 Cline 客户端中，你可以通过自然语言指令或特定的调用方式来触发 'get-current-time' 工具。例如，你可以询问 Cline "现在几点了？" 或 "日本时间现在是几点？"，Cline 可能会调用该工具并返回日本当前时间。

注意: 具体的工具调用方式取决于 Cline 客户端的实现和用户界面。请参考 Cline 客户端的文档或使用说明了解如何调用 MCP 服务器提供的工具。

信息

分类

网页与API

访问项目