使用说明

项目简介

Foundry MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在桥接 AI 助手与 Palantir Foundry 平台。它允许 AI 助手通过标准化的 MCP 协议，安全访问和操作 Foundry 中的数据集、本体对象和功能，从而实现更智能的数据分析和应用集成。

主要功能点

数据集访问: 支持列出和查询 Foundry 中的数据集，允许AI助手检索和分析存储在 Foundry 中的数据。
本体对象访问: 支持列出和查询 Foundry 本体中定义的各种对象类型及其属性，使AI助手能够理解和利用 Foundry 数据模型。
功能执行: 支持列出和执行 Foundry 中已注册的功能，允许AI助手调用 Foundry 的计算和处理能力。
环境配置: 通过环境变量灵活配置 Foundry 连接信息，支持用户令牌和 OAuth2 客户端认证方式。
易于部署: 提供使用 'uv' 运行服务器的简易方式，方便用户快速部署和测试。

安装步骤

克隆仓库

git clone [email protected]:qwert666/mcp-server-foundry.git
cd mcp-server-foundry

安装依赖 确保已安装 Python 3.9+ 和 'uv' (可以使用 'pip install uv' 安装)。然后，在项目目录下使用 'uv pip install .' 安装项目依赖。
```
uv pip install .
```
或者使用 pip 安装：
```
pip install .
```

服务器配置

MCP 客户端需要配置以下 JSON 格式的 'mcpServers' 信息来连接 Foundry MCP 服务器。请根据您的 Foundry 环境和访问权限进行配置。

{
  "mcpServers": {
    "foundry": {
      "command": "uv",
      "args": [
        "--directory",
        "<path_to_mcp_server_foundry>",  // 替换为 mcp-server-foundry 仓库的路径
        "run",
        "mcp-server-foundry"
      ],
      "env": {
        "HOSTNAME": "<hostname>",          // 您的 Foundry 主机名 (必填)
        "TOKEN": "<user_token>",          // Foundry 用户令牌 (可选，提供则优先使用)
        "CLIENT_ID": "<client_id>",      // Foundry 服务用户客户端 ID (必填，当TOKEN未提供时使用)
        "CLIENT_SECRET": "<client_secret>", // Foundry 服务用户客户端密钥 (必填，当TOKEN未提供时使用)
        "SCOPES": "<oauth_scopes>",       // OAuth 权限范围 (可选)
        "ONTOLOGY_ID": "<ontology_id>"    // 您的 Foundry Ontology ID (必填)
      }
    }
  }
}

配置参数说明:

'server name': 'foundry' (可自定义，客户端根据此名称连接服务器)
'command': 'uv' (指定使用 uv 运行器)
'args': 运行参数，包括仓库路径和运行命令 'run mcp-server-foundry'
'env': 环境变量配置，包含 Foundry 连接所需的认证信息和 Ontology ID。
- 'HOSTNAME': 必填，您的 Foundry 实例的主机名，例如 'your-foundry-instance.palantirfoundry.com'。
- 'TOKEN': 可选，Foundry 用户令牌。如果提供，服务器将使用用户令牌进行身份验证。您可以在 Foundry 用户设置页面生成用户令牌。
- 'CLIENT_ID', 'CLIENT_SECRET': 必填 (当 'TOKEN' 未提供时)，Foundry 服务用户的客户端 ID 和密钥。用于 OAuth2 客户端认证。您需要在 Foundry 开发者控制台中创建服务用户并获取这些信息。
- 'SCOPES': 可选，OAuth 权限范围。根据服务用户所需权限配置，默认为 'None'。
- 'ONTOLOGY_ID': 必填，您要访问的 Foundry Ontology 的 ID。

注意: 请根据您的实际 Foundry 环境配置环境变量。如果提供 'TOKEN'，则优先使用用户令牌认证；否则，将使用 'CLIENT_ID' 和 'CLIENT_SECRET' 进行 OAuth2 客户端认证。

基本使用方法

启动 Foundry MCP 服务器。
在 MCP 客户端中配置上述 'mcpServers' 信息，并连接到名为 'foundry' 的服务器。
使用 MCP 客户端提供的工具，例如：
- 列出 Foundry Ontology 中的对象类型。
- 查询特定对象类型的数据。
- 查询 Foundry 数据集。
- 列出和执行 Foundry 功能。

具体工具的使用方法请参考 MCP 客户端的文档。您可以通过客户端调用服务器提供的各项工具，与 Foundry 数据进行交互。

关键词