factorio-ai-companion
🥈SilverAI companions for Factorio 2.x via MCP. 51 RCON commands, hybrid mining, autonomous skills. Control companions with natural language through Claude Code.
810Updated 2mo ago
Intermediate30min to implementautomation
Saves ~80 min per use
Quick InstallView Source
git clone https://github.com/lveillard/factorio-ai-companion.gitWorks with:
Claude
Overview
About This Skill
Factorio AI Companion creates a bidirectional communication channel between Claude Code and Factorio 2.x multiplayer servers using the MCP protocol and RCON. Players send messages prefixed with /companion in Factorio chat, which Claude Code receives and can respond to, enabling natural language interaction with the game. The skill bridges Node.js (via Bun) with Factorio's Lua mod system, establishing a TCP connection to Factorio's RCON server on port 27000. This foundation supports future phases including AI-controlled characters, game state introspection, and automated building tasks. Setup requires installing a Factorio mod, configuring RCON in the game's config file, and running the MCP server locally.
How to Use
Install the included Factorio mod to your mods directory, configure RCON in Factorio's config.ini (port 27000, password 'factorio'), then run the MCP server with 'bun run src/index.ts'. Type '/companion [message]' in Factorio chat—Claude Code will receive it via get_companion_messages tool and can respond with send_companion_message.
Use Cases
Get real-time game status updates from Factorio chat while playing
Send Claude-generated advice or planning strategies to teammates in-game
Create custom game narratives by having Claude respond to player messages
Prototype AI coordination logic between Claude and future autonomous agents
Tags
Setup & Installation
Quick Install
No install command available. Check the GitHub repository for manual installation instructions.
Alternative Install (Git Clone)
git clone https://github.com/lveillard/factorio-ai-companionRequirements
- Claude Code or compatible AI agent
- Works with: Claude
Quick Start Guide
1
Install the Skill
Copy the install command above and run it in your terminal.
2
Open Your AI Agent
Launch Claude Code, Cursor, or your preferred AI coding agent.
3
Try It Out
Use the prompt template or examples below to test the skill.
4
Customize
Adapt the skill to your specific use case and workflow.
Usage Examples
Prompt Template
Create a Factorio AI companion named [NAME] with the following skills: [SKILLS]. The companion should prioritize [PRIORITIES] and avoid [RESTRICTIONS]. Provide the MCP configuration and Claude Code instructions for deployment.
Example Output
Based on your request, I've created an AI companion named 'MinerMax' with the following skills: hybrid mining, resource prioritization, and automated construction. MinerMax will focus on iron ore and copper mining while avoiding areas with high enemy presence. Here's the MCP configuration: ``` [MCP] Name = MinerMax Skills = hybrid_mining, resource_prioritization, automated_construction Priorities = iron_ore, copper Restrictions = high_enemy_presence ``` To deploy MinerMax, use the following Claude Code instructions: ``` !deploy mcp MinerMax !set mining_priority iron_ore copper !set avoidance high_enemy_presence ``` MinerMax is now ready to assist you in your Factorio base. It will start by setting up mining outposts and expanding your resource gathering capabilities.
Apply to these tools
Browse all toolsClaude
AI assistant built for thoughtful, nuanced conversation
Microsoft Teams
Get more done every day with Microsoft Teams – powered by AI
Drata
Automate security compliance and monitor real-time security posture seamlessly.
GPT for work
Automate your spreadsheet tasks with AI power
Respell
Agentic AI Workflow platform
Notion
Connected workspace for docs, wikis, and projects
Compatible MCP servers
Browse all MCP servers
Find the right skills for your stack
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan