AI导哈

扫雷MCP服务器

一个基于Rails 8的扫雷Web/API操作工具，通过stdio与MCP Host（如Claude Code/Desktop）通信。

  • by geeknees
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 geeknees/minesweeper-mcp

使用说明

扫雷舰mcp（stdio）

使用Rails8上运行的Minesweeper Web/AAPI stdio MCP服务器 是。
作为工具从MCP主机（如Claude Code/Claude Desktop）调用。

  • 起动： npx minesweeper-mcp（公开后）
  • 通信：stdio（stdout仅限MCP协议/日志仅限stderr）
  • 操作：针对Rails的REST API start/open/flag/chord/end 呼唤

API 人工智能扫雷艇

快速开始

1) 必要要件

  • Node.js 22+（推奨: 24+）
  • Rails侧的Web/API已启动

2）环境变数

  • MINESWEEPER_BASE_URL （必须）： https://example.com（推荐无尾斜线）
  • MINESWEEPER_BEARER_TOKEN（操作系统必需）：Rails侧发行的token

例:

export MINESWEEPER_BASE_URL="https://example.com"
export MINESWEEPER_BEARER_TOKEN="xxxxxx"

3）本地启动（开发中）

npm install
npm run build
node dist/index.js

详细： docs/development.md

MCP的设定方法（Host侧）

在MCP主机（Claude Desktop/Claude Code等）的设置文件中，注册为stdio服务器。
在本地移动时 dist/index.js 之后由应用程序进行调用。

本地开发（直接启动dist）

{
  "mcpServers": {
    "minesweeper": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/minesweeper-mcp/dist/index.js"],
      "env": {
        "MINESWEEPER_BASE_URL": "http://localhost:3000",
        "MINESWEEPER_BEARER_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

发布后（npx启动）

{
  "mcpServers": {
    "minesweeper": {
      "command": "npx",
      "args": ["-y", "github:geeknees/minesweeper-mcp"],
      "env": {
        "MINESWEEPER_BASE_URL": "https://example.com",
        "MINESWEEPER_BEARER_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

配置文件的位置和重新装入方法请按照所使用的MCP主机文档进行操作。

文档

  • MCP工具参考： docs/tools.md
  • 开发指南： docs/development.md
  • Rails API概述： docs/api.md
  • 背景文章： docs/minesweeper-mcp-article.md

许可证

麻省理工学院

相关 MCP