<p align="right"> <a href="https://autorelease.general.dmz.palantir.tech/palantir/palantir-mcp"><img src="https://img.shields.io/badge/执行-Autorelease-success.svg" alt="Autorelease"></a> </p>

Palantir MCP

一个轻量级的开源包装器，用于从安全的Foundry环境中下载和安装@palantir/mcp包。

概述

此工具提供了一种简化的方式，可以从Foundry环境中访问并运行Palantir的模型上下文协议（MCP）服务器。它自动处理身份验证、包检索和环境设置。

工作原理

1. 预飞行检查：验证Node.js版本、与Foundry的网络连接以及令牌身份验证
2. 注册表设置：配置NPM以使用Foundry的内部包注册表
3. 包执行：从您的安全Foundry环境中下载并运行最新的@palantir/mcp包，并使用您提供的参数

🛠️ 安装

要求

• Node.js 18或更高版本
• 访问有效的Foundry实例
• 具有适当权限的Foundry用户令牌

MCP Inspector

使用mcp-inspector包测试palantir-mcp。

# 将下面的内容替换为您自己的Foundry URL
export FOUNDRY_HOST="<enrollment>.palantirfoundry.com"

# 将下面的内容替换为您自己的Foundry Token
export FOUNDRY_TOKEN=<token>

npx @modelcontextprotocol/inspector \
  npx -y palantir-mcp \
  --foundry-api-url \
  https://$FOUNDRY_HOST

Claude Code

# 将下面的内容替换为您自己的Foundry URL
export FOUNDRY_HOST="<enrollment>.palantirfoundry.com"

# 将下面的内容替换为您自己的Foundry Token
export FOUNDRY_TOKEN=<token>

claude mcp add palantir-mcp \
    --scope user \
    -e FOUNDRY_TOKEN=$FOUNDRY_TOKEN \
    -- npx "-y" "palantir-mcp" "--foundry-api-url" "https://$FOUNDRY_HOST"

Cursor

{
  "mcpServers": {
    "palantir-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "palantir-mcp",
        "--foundry-api-url",
        "https://<enrollment>.palantirfoundry.com" // 将其替换为您自己的Foundry URL
      ],
      "env": {
        "FOUNDRY_TOKEN": "<token>" // 将其替换为您自己的Foundry Token
      }
    }
  }
}

VS Code Copilot

"mcp": {
    "inputs": [
        {
            "type": "promptString",
            "id": "foundry-token",
            "description": "Foundry用户令牌",
            "password": true
        }
    ],
    "servers": {
        "Palantir": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "palantir-mcp",
                "--foundry-api-url",
                "https://<enrollment>.palantirfoundry.com" // 将其替换为您自己的Foundry URL
            ],
            "env": {
                "FOUNDRY_TOKEN": "${input:foundry-token}"
            }
        }
    }
}

Cline

{
  "mcpServers": {
    "palantir-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "palantir-mcp",
        "--foundry-api-url",
        "https://<enrollment>.palantirfoundry.com" // 将其替换为您自己的Foundry URL
      ],
      "env": {
        "FOUNDRY_TOKEN": "<token>" // 将其替换为您自己的Foundry Token
      },
      "disabled": false
    }
  }
}

开发

# 安装依赖
npm install

# 在开发模式下运行
npm run dev -- --foundry-api-url https://<enrollment>.palantirfoundry.com --foundry-token <token>

# 运行测试
npm test

# 运行带有覆盖率的测试
npm run test:coverage

# 构建生产环境
npm run build

# 代码检查和格式化
npm run lint
npm run format

架构

该工具组织成专注的模块：

• cli.ts - 命令行参数解析和验证
• spawn.ts - 进程启动和信号处理
• registry.ts - NPM注册表URL构建
• errors.ts - 自定义错误类以实现更好的错误处理
• preflightChecks.ts - 验证环境和凭证
• index.ts - 主要编排逻辑

错误处理

该工具提供了常见问题的详细错误消息：

• Node版本错误：当Node.js版本低于18时
• 网络错误：当无法到达Foundry API时
• 认证错误：当令牌无效或已过期时
• 包获取错误：当无法检索MCP包时

贡献

欢迎贡献！请确保：

1. 所有测试通过（npm test）
2. 代码经过适当的检查（npm run lint）
3. 代码已经格式化（npm run format）
4. 类型检查通过（npm run typecheck）

许可证

MIT - 查看LICENSE文件了解详情

支持

对于以下内容的问题：

• 此包装器工具：请在此仓库中打开一个问题
• 底层的@palantir/mcp包：联系Foundry支持
• Foundry访问或令牌：联系您的Foundry管理员