cefi data MCP server

CEFI数据MCP服务器

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

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

安装

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

______________________________________________________________________

概述设置步骤

1. 克隆存储库\

使用以下命令将MCP服务器代码下载到本地计算机 git clone.

1. 安装依赖项\

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

1. 配置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)

1. 创建Claude Desktop配置文件（任何文本编辑器。使用vscode进行演示）

#### Mac/Linux

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

#### 视窗

   code $env:AppData\Claude\claude_desktop_config.json

1. 复制将以下内容粘贴到配置文件中

#### 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上。

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

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

______________________________________________________________________

CEFI AI代理演示

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

克劳德 :

Claude Desktop CEFI AI demo

*点击图片回放*