Infactory MCP 服务器

这是一个用于与 Infactory API 进行交互的模型上下文协议（Model Context Protocol，MCP）服务器。此服务器允许语言模型访问和操作您的 Infactory 环境中的数据。

功能

• 项目管理：列出、获取和创建项目
• 查询程序：列出和执行查询程序
• 数据源：列出、获取和创建数据源
• 用户与团队管理：获取当前用户信息并列出团队

入门指南

先决条件

• Infactory API 密钥
• Node.js 18+（用于本地安装）

安装

使用 NPX（推荐）

npx -y @infactory/infactory-mcp

使用 Docker

docker run -i --rm \
  -e NF_API_KEY="your_api_key_here" \
  @infactory/infactory-mcp

环境变量

• NF_API_KEY（必填）：您的 Infactory API 密钥
• NF_BASE_URL（可选）：如果您使用不同的环境，可以指定自定义的 API 终点

可用工具

项目工具

• list_projects：列出所有可用项目

  • 无需参数

• get_project：获取特定项目的详细信息

  • 参数：
    • project_id（字符串）：要获取的项目的 ID

• create_project：创建新项目

  • 参数：
    • name（字符串）：项目名称
    • description（字符串，可选）：项目描述
    • team_id（字符串）：团队 ID

查询程序工具

• list_query_programs：列出项目中的查询程序

  • 参数：
    • project_id（字符串）：项目的 ID

• execute_query_program：执行查询程序

  • 参数：
    • queryprogram_id（字符串）：要执行的查询程序的 ID
    • input_data（对象，可选）：查询程序的输入数据

数据源工具

• list_datasources：列出项目中的数据源

  • 参数：
    • project_id（字符串）：项目的 ID

• get_datasource：获取特定数据源的详细信息

  • 参数：
    • datasource_id（字符串）：要获取的数据源的 ID

• create_datasource：创建新的数据源

  • 参数：
    • name（字符串）：数据源名称
    • type（字符串）：数据源类型
    • config（对象）：数据源配置

用户与团队管理工具

• list_teams：列出所有团队
• get_current_user：获取当前用户信息

配置示例

以下是针对不同工具的配置示例：

Claude Desktop

路径：~/.claudius/config.json

{
  "contextProxies": {
    "infactory-mcp": {
      "command": "node",
      "args": ["path/to/dist/index.js"],
      "env": {
        "NF_API_KEY": "your_api_key_here"
      }
    }
  }
}

Windsurf

路径：~/.config/windsurf/contexts.json

{
  "infactory-mcp": {
    "type": "node",
    "script": "path/to/dist/index.js",
    "env": {
      "NF_API_KEY": "your_api_key_here"
    }
  }
}

Cursor

路径：~/.cursor/contexts.json

{
  "infactory-mcp": {
    "type": "node",
    "script": "path/to/dist/index.js",
    "env": {
      "NF_API_KEY": "your_api_key_here"
    }
  }
}

构建

如果您需要本地构建服务器，可以按照以下步骤操作：

git clone your_repository.git
cd your_repository
npm install
npm run build
node dist/index.js

可选调试命令：

@modelcontextprotocol/inspector -e "NF_API_KEY=$NF_API_KEY" node -- dist/index.js

许可证

MIT 许可证