Infactory MCP

🚀 Infactory MCP Server

This is a Model Context Protocol (MCP) server designed to interact with the Infactory API. This server enables language models to access and manipulate data in your Infactory environment.

✨ Features

• Project Management: List, retrieve, and create projects.
• Query Programs: List and execute query programs.
• Data Sources: List, retrieve, and create data sources.
• User and Team Management: Get current user information and list teams.

🚀 Quick Start

Prerequisites

• Infactory API key
• Node.js 18+ (for local installation)

Installation

Using NPX (Recommended)

npx -y @infactory/infactory-mcp

Using Docker

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

Environment Variables

• NF_API_KEY (Required): Your Infactory API key.
• NF_BASE_URL (Optional): Specify a custom API endpoint if you are using a different environment.

📦 Available Tools

Project Tools

• list_projects: List all available projects.
  • No parameters required.
• get_project: Get detailed information about a specific project.
  • Parameters:
    • project_id (string): The ID of the project to retrieve.
• create_project: Create a new project.
  • Parameters:
    • name (string): The name of the project.
    • description (string, optional): The description of the project.
    • team_id (string): The ID of the team.

Query Program Tools

• list_query_programs: List query programs in a project.
  • Parameters:
    • project_id (string): The ID of the project.
• execute_query_program: Execute a query program.
  • Parameters:
    • queryprogram_id (string): The ID of the query program to execute.
    • input_data (object, optional): The input data for the query program.

Data Source Tools

• list_datasources: List data sources in a project.
  • Parameters:
    • project_id (string): The ID of the project.
• get_datasource: Get detailed information about a specific data source.
  • Parameters:
    • datasource_id (string): The ID of the data source to retrieve.
• create_datasource: Create a new data source.
  • Parameters:
    • name (string): The name of the data source.
    • type (string): The type of the data source.
    • config (object): The configuration of the data source.

User and Team Management Tools

• list_teams: List all teams.
• get_current_user: Get current user information.

💻 Usage Examples

Configuration Examples

Claude Desktop

Path: ~/.claudius/config.json

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

Windsurf

Path: ~/.config/windsurf/contexts.json

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

Cursor

Path: ~/.cursor/contexts.json

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

Building the Server

If you need to build the server locally, follow these steps:

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

Optional debugging command:

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

📄 License

This project is licensed under the MIT License.