🚀 Infactory MCP 服务器

Infactory MCP 服务器是一个基于模型上下文协议（Model Context Protocol，MCP）的服务器，它能与 Infactory API 进行交互。借助该服务器，语言模型可以访问并操作您的 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 许可证。