Factorio MCP Server

🚀 Factorio MCP Server

This doesn't work lol

📋 To-Do List

• Use the tools in this repository instead: https://github.com/teoxoy/factorio-blueprint-editor/blob/master/packages/editor/
• Generate an image after each request

🚀 MCP Starter Server

A minimal ModelContextProtocol server template for building AI assistant tools. This starter provides a basic structure for creating MCP tools that can be used with AI assistants like Claude.

✨ Features

• A simple "hello world" tool example
• TypeScript + esbuild project setup
• Development tools are pre-configured

🚀 Quick Start: How to Build and Run with Claude

1. Download and install Claude Desktop.

2. Clone this repository, install dependencies, and build:

npm install
npm run build

3. Configure Claude to use this MCP server. If this is your first MCP server, run the following in the project root directory:

echo '{
  "mcpServers": {
    "mcp-starter": {
      "command": "node",
      "args": ["'$PWD'/dist/index.cjs"]
    }
  }
}' > ~/Library/Application\ Support/Claude/claude_desktop_config.json

This will add something like the following to your claude_desktop_config.json:

"mcpServers": {
  "mcp-starter": {
    "command": "node",
    "args": ["/Users/matt/code/mcp-starter/dist/index.cjs"]
  }
}

If you already have other MCP servers, add the mcp-starter block to your existing configuration. Importantly, args should be /path/to/your_repo_on_machine/mcp-starter/dist/index.cjs.

4. Restart Claude Desktop.

5. Look for the hammer icon and the number of available tools in Claude's interface to confirm the server is running.

6. If everything works, you can develop this MCP server using npm run dev and test it in Claude. Restart Claude each time you need to restart the server.

💻 Development with Inspector

For development and debugging purposes, you can use the MCP Inspector tool. The Inspector provides a visual interface for testing and monitoring MCP server interactions. Visit the Inspector documentation for detailed setup instructions.

To test with the Inspector locally:

npm run inspect

To build on file changes:

npm run watch

Or run the watcher and inspector simultaneously:

npm run dev

🚀 Publishing

When you're ready to publish your server, it's easy!

1. Set up an NPM account.

2. Run npm publish. This will publish the package using the project name in package.json.

3. Once published, others can install your server via a configuration entry:

"mcpServers": {
  "<your-package-name>": {
    "command": "npx",
    "args": ["<your-package-name>"]
  }
}

🛠️ Available Tools

The server provides the following tools:

• hello_tool: A simple example tool with a name parameter that returns a greeting.

🆕 Creating New Tools

To add a new tool:

1. Define the tool schema in index.ts.
2. Add it to the tools array in the ListToolsRequestSchema handler.
3. Add its implementation in the CallToolRequestSchema handler. Check the implementation of hello_tool as an example.