MCP服务器

CEFI Data MCP服务器是一个基于模型上下文协议(MCP)的服务器组件,用于构建个性化的AI代理,处理、分析和交互外部数据,支持数据查询、分析和交互式绘图。

  • by NOAA-CEFI-Portal
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 noaa-cefi-portal/cefi_data_mcp_server

使用说明

CEFI数据MCP服务器

此存储库提供了使用 模型上下文协议(MCP).MCP使您能够构建一个个性化的“代理”,该代理利用各种大型语言模型(LLM)来处理、分析和与外部数据交互。通过创建MCP服务器,您可以创建根据您的特定要求定制的智能代理。在这里,我们构建了CEFI MCP服务器,作为用户的个人“CEFI AI代理”,用于各种CEFI数据查询、数据分析,甚至在LLM客户端支持的情况下创建交互式绘图。

其想法是创建特定于主题或事件的MCP服务器,专注于利用相关的外部资源。这些服务器管理有用的数据或信息并将其返回给LLM,使其能够根据用户的需求生成结构化的、特定于资源的响应。

安装

安装步骤可能因您的MCP客户端或AI应用程序(如带小拷贝的VS Code或Claude Desktop)而异。下面,我们概述了使用本地环境设置Claude Desktop的过程。通过这种方法,MCP服务器在您的本地计算机上运行,并取决于您的互联网连接。计划在未来的版本中支持远程服务器部署。


概述设置步骤

  1. 克隆存储库
    使用以下命令将MCP服务器代码下载到本地计算机 git clone.

  2. 安装依赖项
    安装 uv 并使用它来设置MCP服务器所需的Python环境。

  3. 配置Claude桌面
    创建并编辑Claude Desktop配置文件以注册您的MCP服务器,然后在Claude Desktop应用程序中启用它们。


克隆存储库

对于本地设置,首先将此存储库克隆到您的计算机上。在首选目录中,运行:

git clone git@github.com:NOAA-CEFI-Portal/cefi_data_mcp_server.git

安装依赖项

将存储库克隆到本地目录后,您需要 uv,一个非常快的Python包和项目管理器。

如果 uv 您的计算机上尚未安装,请根据您的操作系统按照以下说明进行操作:

Mac/Linux

# Use curl
curl -LsSf https://astral.sh/uv/install.sh | sh

视窗

# Install uv if not already installed
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

曾经 uv 已安装,您可以使用 uv 设置运行MCP服务器所需的Python环境。

# go to the repository
cd /ABSOLUTE/PATH/TO/PARENT/FOLDER/cefi_data_mcp_server/

# use uv to create the virtual environment based on the uv.lock file
uv sync

# activate the virtual env for testing the MCP function (optional)
source .venv/bin/activate


配置Claude桌面

这 MCP页面 也有有用的解释和设置。在这里,我们总结为以下步骤。

  1. 下载最新版本的Claude Desktop(https://claude.ai/download)

  2. 创建Claude Desktop配置文件(任何文本编辑器。使用vscode进行演示)

    Mac/Linux

    code ~/Library/Application\ Support/Claude/claude_desktop_config.json
    

    视窗

    code $env:AppData\Claude\claude_desktop_config.json
    
  3. 复制将以下内容粘贴到配置文件中

    Mac/Linux

    {
      "mcpServers": {
        "mcp_cefi_analysis": {
          "command": "uv",
          "args": [
            "--directory",
            "/ABSOLUTE/PATH/TO/PARENT/FOLDER/cefi_data_mcp_server",
            "run",
            "mcp_cefi_analysis.py"
          ]
        },
        "mcp_cefi_data_query": {
          "command": "uv",
          "args": [
            "--directory",
            "/ABSOLUTE/PATH/TO/PARENT/FOLDER/cefi_data_mcp_server",
            "run",
            "mcp_cefi_data_query.py"
          ]
        }
      }
    }
    

    视窗

    {
      "mcpServers": {
        "mcp_cefi_analysis": {
          "command": "uv",
          "args": [
            "--directory",
            "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\cefi_data_mcp_server",
            "run",
            "mcp_cefi_analysis.py"
          ]
        },
        "mcp_cefi_data_query": {
          "command": "uv",
          "args": [
            "--directory",
            "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\cefi_data_mcp_server",
            "run",
            "mcp_cefi_data_query.py"
          ]
        }
      }
    }
    

    !!!小心!!!

    对于 "command": "uv",您可能需要在命令字段中输入uv可执行文件的完整路径。你可以通过跑步来获得这个 which uv 在macOS/Linux或 where uv 在Windows上。

  4. 在Claude Desktop中启用MCP服务器

    在用户可以键入问题和命令的输入框正下方,查找搜索和工具按钮。 应该可以通过禁用单选按钮看到工具列表。如果未显示,请关闭Claude Desktop App并重新打开以查看是否显示。


CEFI AI代理演示

提示 :“你能给我看看基于最新西北大西洋预报的海面温度预报图吗?”

克劳德 :

点击图片回放