Back to MCP directory
publicPublicdnsLocal runtime

factorio-mcp-server

一个用于构建AI助手工具的ModelContextProtocol服务器模板,提供基础结构和开发工具配置

article

README

🚀 Factorio MCP 服务器

这个项目旨在提供一个 Factorio MCP 服务器,不过目前似乎有些问题,“这个不起作用 lol”。该项目还包含一个最小的 ModelContextProtocol 服务器模板,可用于构建 AI 助手工具。

🚀 快速开始

待办事项

  • 使用此仓库中的工具代替:工具链接
  • 每次请求后生成一张图片

启动 MCP 服务器

特性

  • 简单的 "hello world" 工具示例
  • TypeScript + esbuild 项目设置
  • 开发工具已预先配置

使用说明:如何使用Claude构建和运行

  1. 下载并安装 Claude Desktop
  2. 克隆此仓库,安装依赖项并构建:
npm install
npm run build
  1. 配置 Claude 使用此 MCP 服务器。如果这是你的第一个 MCP 服务器,请在项目根目录运行:
echo '{
  "mcpServers": {
    "mcp-starter": {
      "command": "node",
      "args": ["'$PWD'/dist/index.cjs"]
    }
  }
}' > ~/Library/Application\ Support/Claude/claude_desktop_config.json

这将在你的 claude_desktop_config.json 中添加类似以下内容:

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

如果你已经有其他 MCP 服务器,请将 mcp-starter 块添加到现有配置中。重要的是,args 应该是 /path/to/your_repo_on_machine/mcp-starter/dist/index.cjs。 4. 重启 Claude Desktop。 5. 在 Claude 的界面中查找锤子图标和可用工具数量,以确认服务器正在运行。 6. 如果一切正常,你可以使用 npm run dev 开发此 MCP 服务器,并在 Claude 中测试。每次需要重新启动时,请重启 Claude。

使用 Inspector 进行开发

为了开发和调试目的,可以使用 MCP Inspector 工具。Inspector 提供了一个可视化的界面,用于测试和监控 MCP 服务器交互。 访问 Inspector 文档 以获取详细设置说明。

  • 要本地使用 Inspector 测试:
npm run inspect
  • 要在文件更改时构建:
npm run watch
  • 或者同时运行观察器和 inspector:
npm run dev

发布

准备好发布你的服务器后,很简单!

  1. 设置一个 NPM 账户。
  2. 运行 npm publish。这将使用 package.json 中的项目名称发布包。
  3. 一旦发布,其他人可以通过配置条目安装你的服务器:
"mcpServers": {
  "<your-package-name>": {
    "command": "npx",
    "args": ["<your-package-name>"]
  }
}

可用工具

服务器提供以下工具:

  • hello_tool:一个简单的示例工具,带有 name 参数,并返回问候语。

创建新工具

要添加新的工具:

  1. index.ts 中定义工具模式
  2. 将其添加到 ListToolsRequestSchema 处理器的工具数组中
  3. CallToolRequestSchema 处理器中添加其实现 查看 hello_tool 的实现作为示例。
help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client