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 ライセンス