Elephant MCP

大象MCP服务器

Elephant MCP将与Claude兼容的客户端连接到Elephant数据图，提供可发现的工具，用于列出数据组、类和单个属性模式。服务器在npm上发布为 @elephant-xyz/mcp.

嵌入提供程序： 这 getVerifiedScriptExamples 该工具使用文本嵌入进行语义代码搜索。服务器支持两个嵌入提供程序： - 开放人工智能 （优先考虑以下情况 OPENAI_API_KEY 已设置）-用途 text-embedding-3-small 1024个维度 - AWS基岩 （自动回退）-用途 amazon.titan-embed-text-v2 通过IAM身份验证 在AWS上运行时，如果没有提供OpenAI密钥，服务器会自动使用Bedrock。

🚀 快速建议

为了使用Elephant MCP获得最佳效果，请务必在提示中指定您正在处理的数据组并添加 use elephant mcp 最后。

示例提示：

"I'm working on the 'County' data group. Can you help me explore the available classes? use elephant mcp"

"What properties are available in the 'property' class? I'm working with the 'County' data group. use elephant mcp"

这有助于人工智能了解使用哪种数据上下文，并确保它有效地利用Elephant MCP工具。

为什么是大象？

• 即用型 npx 启动器与Claude、Cursor、VS Code、Gemini CLI和其他MCP客户端兼容。
• 用于枚举Elephant数据组、相关类和完整JSON模式片段的工具。
• 结构化MCP日志记录，将诊断信息流式传输到每个连接的客户端。

可用工具

• listClassesByDataGroup 列出附加到Elephant数据组的类，包括友好的名称和描述。
• listPropertiesByClassName –返回类的架构属性键（不包括仅传输字段）。
• getPropertySchema –获取特定属性和类组合的完整JSON模式。
• getVerifiedScriptExamples –返回代码的工作示例列表，将数据映射到Elephant模式。

支持的MCP客户端

光标

1. 确保已安装Node.js 22.18+。
2. Cursor将打开一个预先填充了以下内容的配置屏幕：

   {
     "command": "npx",
     "args": ["-y", "@elephant-xyz/mcp@latest"],
     "env": {
       // Option 1: Use OpenAI embeddings
       "OPENAI_API_KEY": "sk-your-openai-key",
       // Option 2: Use AWS Bedrock (omit OPENAI_API_KEY)
       // "AWS_REGION": "us-east-1"  // optional, defaults to us-east-1
     },
   }

对于OpenAI，将占位符替换为实际的密钥。对于AWS Bedrock，请删除 OPENAI_API_KEY 行，并确保您的环境具有有效的AWS凭据（IAM角色、环境变量或AWS凭据文件）。

1. 在Cursor的MCP面板中保存并切换Elephant连接。
2. 如果您正在入侵本地结账，请将命令切换为 npm start 并设置 cwd 到您的存储库路径。

Visual Studio Code

1. 安装 模型上下文协议 扩展。
2. 接受上面预先填充的安装流程，或在下面手动添加 _设置→ MCP → 服务器_ 与：

- OpenAI： OPENAI_API_KEY=sk-your-openai-key npx -y @elephant-xyz/mcp@latest - AWS基岩： npx -y @elephant-xyz/mcp@latest （使用环境中的IAM凭据）

1. 重新加载VS代码并在MCP面板中启用Elephant服务器。

克劳德代码

macOS/Linux与OpenAI：

claude mcp add elephant --env OPENAI_API_KEY=sk-your-openai-key -- npx -y @elephant-xyz/mcp@latest

macOS/Linux与AWS Bedrock（使用IAM凭据）：

claude mcp add elephant -- npx -y @elephant-xyz/mcp@latest

添加服务器后重新启动Claude Code，以便工具显示在 @tools 调色板。

OpenAI Codex

• CLI设置

使用OpenAI：

  codex mcp add elephant --env OPENAI_API_KEY=sk-your-openai-key -- npx -y @elephant-xyz/mcp@latest

使用AWS Bedrock：

  codex mcp add elephant -- npx -y @elephant-xyz/mcp@latest

您可以通过以下方式探索其他选项 codex mcp --help.在Codex TUI内部，运行 /mcp 查看当前连接的服务器。

• config.toml设置

编辑 ~/.codex/config.toml （或打开 _MCP设置→ 打开config.toml_ 从IDE扩展）并添加：

对于OpenAI：

  [mcp.elephant]
  command = "npx"
  args = ["-y", "@elephant-xyz/mcp@latest"]
  env = { OPENAI_API_KEY = "sk-your-openai-key" }

对于AWS基岩：

  [mcp.elephant]
  command = "npx"
  args = ["-y", "@elephant-xyz/mcp@latest"]
  # Uses IAM credentials from environment; optionally set AWS_REGION

保存文件并重新启动Codex以加载新服务器。

Gemini CLI

创建（或编辑） .gemini/settings.json 在您的项目中添加：

使用OpenAI：

{
  "mcpServers": {
    "elephant": {
      "command": "npx",
      "args": ["-y", "@elephant-xyz/mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "sk-your-openai-key",
      },
    },
  },
}

使用AWS Bedrock：

{
  "mcpServers": {
    "elephant": {
      "command": "npx",
      "args": ["-y", "@elephant-xyz/mcp@latest"],
      // Uses IAM credentials from environment
    },
  },
}

重新启动Gemini CLI或运行 gemini tools sync 拿起新服务器。

配置

stdio传输意味着不需要端口或服务器标识标志。由处理的环境变量 src/config.ts:

AWS基岩身份验证

使用AWS Bedrock时（否 OPENAI_API_KEY set），服务器使用标准AWS凭证链进行身份验证：

1. 环境变量(AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY)
2. 共享凭据文件(~/.aws/credentials)
3. ECS/Lambda容器凭据(AWS_CONTAINER_CREDENTIALS_*)
4. IAM实例角色（在EC2/ECS/Lambda上运行时）

确保您的IAM角色或用户具有 bedrock:InvokeModel 权限和访问 amazon.titan-embed-text-v2:0 在配置中嵌入模型 AWS_REGION。在某些地区，您必须在AWS Bedrock控制台中明确请求访问此模型，然后才能调用它。

重要提示： 必须至少配置一个嵌入提供程序。如果两者都没有 OPENAI_API_KEY AWS凭据不可用 getVerifiedScriptExamples 该工具将返回一个错误，提示您配置凭据。

凭证验证

启动时，服务器验证嵌入提供程序凭据：

• 对于 开放人工智能：检查 OPENAI_API_KEY 已设置
• 对于 AWS基岩：通过完整的AWS凭据提供程序链解析凭据，并记录检测到的源

验证结果被记录并包含在MCP启动消息中以进行调试。

数据库兼容性

当在具有不同向量维度的嵌入模型之间切换时（例如，从1536维模型切换到1024维模型），嵌入数据库会自动重建。这确保了 getVerifiedScriptExamples 模型更改后，该工具仍能正常工作。重建后，服务器将重新索引所有已验证的脚本。

Zod兼容性说明：此服务器及其依赖项需要 zod v3。如果将v4副本提升到中，安装将失败 node_modules postinstall 脚本强制执行v3约束以避免运行时错误，例如 keyValidator._parse is not a function.

需要贡献吗？

开发设置、测试和发布工作流已上线 CONTRIBUTING.md.

支持

如果遇到问题，请使用Node.js版本、客户端详细信息和任何相关日志输出打开问题。我们很乐意帮助您建立联系。