Infactory MCP

🚀 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 許可證。