项目简介

Elephant MCP 服务器是一个基于 Model Context Protocol (MCP) 的标准化服务,专门为 AI 助手提供对 Elephant 数据图的访问能力。它通过注册工具的方式,让 AI 助手能够发现和查询数据结构、属性以及相关的代码示例。

主要功能点

  • 数据组与类浏览:列出特定数据组下的所有数据类及其描述
  • 属性结构查询:查看特定类的所有属性定义和完整 JSON Schema
  • 代码示例搜索:基于语义搜索查找已验证的代码实现

安装步骤

  1. 确保已安装 Node.js 22.18 或更高版本
  2. 根据您使用的客户端,选择相应的安装方式:

Cursor

  • 点击安装按钮,系统会自动生成配置
  • 配置中包含启动命令:'npx -y @elephant-xyz/mcp@latest"
  1. 配置嵌入服务提供者(二选一):
    • OpenAI:设置 'OPENAI_API_KEY' 环境变量
  • AWS Bedrock:使用 IAM 身份验证(无需 API 密钥)

Visual Studio Code

  • 安装 Model Context Protocol 扩展
  • 添加服务器配置,启动命令为:'npx -y @elephant-xyz/mcp@latest"
    • 如需 OpenAI 嵌入,设置环境变量:'OPENAI_API_KEY=您的密钥"

Claude Code

# OpenAI 版本
claude mcp add elephant --env OPENAI_API_KEY=您的密钥 -- npx -y @elephant-xyz/mcp@latest"
- **AWS Bedrock 版本**:
```bash
claude mcp add elephant -- npx -y @elephant-xyz/mcp@latest"

OpenAI Codex

编辑配置文件 '~/.codex/config.toml',添加:

[mcp.elephant]
command = "npx"
args = ["-y", "@elephant-xyz/mcp@latest"

基本使用方法

  1. 启动支持 MCP 的 AI 客户端(如 Cursor、Claude Code、VS Code 等)
  2. 在 Elephant 数据图中指定您要操作的数据组
  3. 在提示中添加 "use elephant mcp" 以确保 AI 使用正确的工具

示例提示:

  • "我正在处理 'County' 数据组,能帮我探索可用的类吗?use elephant mcp"
  • "'property' 类中有哪些属性可用?我正在使用 'County' 数据组。use elephant mcp"

信息

分类

数据库与文件