使用说明

项目简介

Claude-Light MCP服务器是一个基于Model Context Protocol (MCP) 的应用后端,旨在为LLM客户端(如Claude Desktop)提供访问和控制远程科学仪器的能力。该服务器封装了对 Claude-Light 仪器的操作,允许用户通过自然语言指令,经由LLM客户端,远程控制仪器的RGB LED并获取光传感器数据。

主要功能点

  • 仪器信息查询: 提供 'about' 工具,用于获取 Claude-Light 仪器的详细描述信息,包括其功能和用途。
  • RGB LED 控制与数据采集: 提供 'rgb' 工具,允许用户设置 Claude-Light 仪器的红、绿、蓝 (RGB) LED通道强度,并实时获取光传感器在多个波长下的强度读数。
  • MCP 标准协议: 基于 FastMCP 框架构建,遵循 MCP 协议标准,确保与 MCP 客户端的兼容性和互操作性。
  • 易于安装与集成: 提供安装脚本,方便用户将该 MCP 服务器集成到 Claude Desktop 等 MCP 客户端环境中。

安装步骤

  1. 安装 Python 包: 确保已安装 Python 环境。在仓库根目录下,执行以下命令安装 'claude-light-python' 包:
    pip install .
    或者如果使用可编辑模式进行开发:
    pip install -e .
  2. 安装 MCP 服务器到 Claude Desktop: 安装完成后,在命令行中执行以下命令,将 'claude-light' MCP 服务器配置到 Claude Desktop。请确保 Claude Desktop 已安装。
    cl_mcp install
    执行此命令后,会修改 Claude Desktop 的配置文件,并将 'claude-light' 服务器添加到可用服务器列表中。
  3. 重启 Claude Desktop: 为了使配置生效,请重启 Claude Desktop 应用程序。

服务器配置

MCP 客户端(如 Claude Desktop)需要以下配置信息来连接和使用 Claude-Light MCP 服务器。以下是配置信息的 JSON 格式,通常由客户端自动读取,您只需在安装步骤中正确安装即可。

{
  "serverName": "claude-light",  // MCP 服务器的名称,用于在客户端中标识
  "command": "cl_mcp",        // 启动 MCP 服务器的命令,这里假设安装后 'cl_mcp' 命令在系统路径中可用
  "args": []                   // 启动命令的参数,此服务器无需额外参数
}

基本使用方法

成功安装并重启 Claude Desktop 后,您应该可以在 Claude Desktop 中看到名为 "claude-light" 的 MCP 服务器。您可以通过自然语言指令指示 Claude Desktop 使用该服务器提供的工具。

例如,在 Claude Desktop 中,您可以尝试以下指令:

  • "使用 claude-light 获取仪器描述" (对应 'about' 工具)
  • "使用 claude-light 设置 RGB 红色 0.8,绿色 0.2,蓝色 0.5 并读取数据" (对应 'rgb' 工具,并设置 R=0.8, G=0.2, B=0.5)

Claude Desktop 会将这些自然语言指令转换为对 MCP 服务器的 JSON-RPC 请求,并调用相应的工具来完成操作,最终将结果返回给用户。

关键词: 远程仪器控制, 光谱分析, LED控制, 科学实验, 自动化

信息

分类

桌面与硬件