游戏开发MCP中心

版本1.0.0\ 状态生产就绪\ 构建✅ 通过

一个全面的模型上下文协议（MCP）中心，通过多个MCP服务器聚合了600多种游戏开发工具，为AI助手（如Claude、LM Studio等）提供了一个统一的接口，并具备智能路由和技能集成功能。

______________________________________________________________________

🚀 快速入门

先决条件

Node.js 18及以上版本 （对于集线器）
Python 3.11+ （适用于基于Python的服务器，如Meshy）
Git（版本控制系统） （用于GitHub集成）

安装与启动

# 1. Install dependencies
npm install

# 2. Configure environment
copy .env.example .env
# Edit .env and add your API keys

# 3. Start the hub (recommended)
START_ALL.bat

# Or start with browser auto-open
start-gui-with-browser.bat

该集线器将自动：

✅ 启动图形用户界面（GUI）仪表板 http://localhost:3100
✅ 连接到所有已启用的MCP服务器
✅ 准备好迎接AI客户端的连接 http://localhost:3000/sse

______________________________________________________________________

🏗️ 建筑学

核心组件

┌─────────────────────────────────────────┐
│         AI Clients                      │
│  (Claude, LM Studio, Cursor, etc.)      │
└────────────────┬────────────────────────┘
                 │ MCP Protocol
                 ↓
┌─────────────────────────────────────────┐
│       GameDev MCP Hub                   │
│  ┌────────────────────────────────┐    │
│  │  Smart Router (In Progress)    │    │
│  │  - Spec-Kit Integration        │    │
│  │  - Intent Parsing              │    │
│  │  - Intelligent Tool Selection  │    │
│  └────────────────────────────────┘    │
│                                         │
│  • SSE Transport (multi-client)        │
│  • Stdio Transport (LM Studio)         │
│  • GUI Dashboard (WebSocket)           │
│  • 75+ Tools from 6 servers            │
└────────────────┬────────────────────────┘
                 │
         ┌───────┴────────┐
         ↓                ↓
┌──────────────┐   ┌──────────────┐
│   Tier 1     │   │  Tier 2      │
│   Servers    │   │  Servers     │
└──────────────┘   └──────────────┘

连接的MCP服务器

第一级 - 工作中 （75种工具）：

黑曜石 (18种工具) - 知识管理，资料库搜索
Blender（注：Blender是一个开源的3D创作软件，此处直接保留原名，不进行意译） (17种工具) - 3D建模，场景管理
Godot（游戏引擎名称，可直译为“上帝之光”，但通常直接使用原名） (14种工具) - 游戏引擎，场景创建
GitHub (26个工具) - 版本控制、问题跟踪、拉取请求（或：合并请求）

第二级 - 配置完成:

Meshy AI（可译为“梅西人工智能”或根据具体语境调整为更贴切的名称，但“Meshy”一词在中文中并无直接对应词汇，因此通常保留原词或根据品牌特性进行创意翻译） - 从文本/图像生成3D模型
哨兵 - 错误追踪与监控

______________________________________________________________________

🎯 功能特点

多客户端支持

SSE运输（或译为：苏格兰电力运输公司）多个客户端可以同时连接
Stdio Transport（注：此术语可能根据具体上下文有不同的翻译，但“Stdio”通常可理解为“标准输入输出”（Standard I/O）的缩写，不过在此处作为专有名词或特定技术术语，直接保留原样翻译）与LM Studio直接集成
WebSocket实时图形用户界面更新
智能港口管理自动端口分配（3100-3109）

智能路由器（70%完成）

规格套件集成GitHub 规范驱动开发框架
意图解析自然语言理解
加权排名多因素工具选择
澄清系统处理模糊请求
上下文优化减少了98.3%（从9,000个字符减少到150个字符）

技能系统

算法艺术生成艺术与程序化视觉效果
MCP 构建器构建新的MCP服务器
Anthropic 提供的 11 项待整合技能

图形用户界面仪表盘

实时监控服务器状态，客户端连接
工具浏览器探索75+种可用工具
执行跟踪监控工具的使用情况和性能
响应式设计在桌面和移动设备上均可使用

______________________________________________________________________

📁 项目结构

gamedev-mcp-hub/
├── src/
│   ├── gui/                  # Web dashboard
│   ├── routing/              # Smart Router (70% complete)
│   │   ├── smart-router.ts
│   │   ├── spec-kit-processor.ts
│   │   ├── intent-parser.ts
│   │   └── candidate-ranker.ts
│   ├── server/               # Hub core
│   ├── servers/              # MCP server adapters
│   ├── types/                # TypeScript definitions
│   └── utils/                # Utilities
├── external-servers/         # External MCP servers
│   └── meshy-ai-mcp-server/  # Meshy AI integration
├── skills/                   # Workflow skills
│   ├── algorithmic-art/
│   └── mcp-builder/
├── config/                   # Configuration
│   └── mcp-servers.json      # Server definitions
├── docs/                     # Documentation
├── archive/                  # Historical documentation
└── tests/                    # Test suites

KEY FILES:
├── START_ALL.bat             # Master startup script
├── start-gui-with-browser.bat # Start with auto-open browser
├── README.md                 # This file
├── ROADMAP.md                # Future plans
├── IMPLEMENTATION_STATUS.md  # Smart Router progress
└── START_INSTRUCTIONS.md     # Detailed startup guide

______________________________________________________________________

🔧 配置

环境变量

创造 .env 与以下文件一起：

# Required for GitHub integration
GITHUB_TOKEN=ghp_your_token_here

# Optional: For enhanced features
MESHY_API_KEY=your_meshy_key_here
SENTRY_AUTH_TOKEN=your_sentry_token_here

服务器配置

编辑 config/mcp-servers.json 启用/禁用服务器：

{
  "servers": {
    "obsidian": {
      "enabled": true,
      "command": "path/to/mcp-server.exe"
    },
    "meshy": {
      "enabled": true,
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "external-servers/meshy-ai-mcp-server"
    }
  }
}

______________________________________________________________________

🧪 测试

使用LM Studio

启动集线器跑 START_ALL.bat
打开LM Studio加载一个具有大上下文（8K+个标记）的模型
启用MCP在“程序”选项卡中切换“gamedev-hub”
测试问：“你有哪些可用的工具？”

见 TEST_LM_STUDIO_NOW.md 以获取详细的测试指南。

使用Claude Desktop

在（某处）进行配置 claude_desktop_config.json：

{
  "mcpServers": {
    "gamedev-hub": {
      "command": "node",
      "args": ["D:\\Power\\gamedev-mcp-hub\\dist\\index.js"]
    }
  }
}

______________________________________________________________________

📊 当前状态

实施进度

第一阶段核心路由器 - 70%完成
服务器集成6台服务器已配置，其中4台正在运行
可用工具来自第一梯队服务器的75种工具
构建状态✅ 通过（0个错误）
代码行数约16,000（包括路由系统）

行之有效的方法 ✅

多客户端SSE传输
LM Studio 的标准输入输出传输（或：用于 LM Studio 的标准控制台传输）
带有实时更新的GUI仪表盘
Obsidian、Blender、Godot、GitHub 集成
客户跟踪与监控
智能港口管理
Spec-Kit 处理器
意图解析
候选人排名

进行中 ⏳

智能路由器工具界面（2小时）
单元测试套件（2小时）
13 人类技能整合（第二周）
代理模式系统（第三周）
技能共享引擎（第4周）
多工具工作流程（第5周）

______________________________________________________________________

🎓 使用示例

对于人工智能助手

当连接到集线器时，AI助手可以：

# Knowledge Management
"Search my Obsidian vault for notes about shader programming"

# 3D Modeling  
"Create a cube in Blender and set its dimensions to 2x2x2"

# Game Development
"Create a new Godot scene with a player character"

# Version Control
"Create a GitHub issue for the shader bug"

# 3D Generation (when Meshy enabled)
"Generate a 3D sword model from text description"

技能使用

# Algorithmic Art
"Use the algorithmic-art skill to create a flow field background"

# MCP Builder
"Help me build an MCP server for the Unreal Engine API"

______________________________________________________________________

🗺️ 路线图

见 ROADMAP.md 以了解详细的未来计划。

近期（接下来2-4周）：

✅ 完成智能路由器第一阶段
⏳ 集成13项Anthropic技能
⏳ 添加工厂AI代理模式
⏳ 实施技能分享引擎

中期 (1-3个月)：

多工具工作流编排
高级提示工程
支持1000+种工具
性能优化

长期（3-6个月）：

从使用模式中自动学习
社区技能市场
云部署选项
高级分析仪表板

______________________________________________________________________

🤝 贡献（或“参与贡献”）

看 CONTRIBUTING.md 作为指南。

为贡献者提供的快速入门指南:

为仓库创建分支（或“克隆仓库”）
创建特性分支： git checkout -b feature/my-feature
进行更改并测试
运行构建： npm run build
提交： git commit -m "feat: add feature"
推送并创建拉取请求（Pull Request）

______________________________________________________________________

📚 文档

核心文档

README.md（文件名，可直译为“README点md”，但通常保持原样，不翻译文件名） (此文件) - 概述与快速入门
START_INSTRUCTIONS.md 翻译为中文是：“开始指南.md” 或 “启动说明.md” - 详细的启动指南
ROADMAP.md 翻译为中文是：“路线图.md”。其中，“ROADMAP”表示“路线图”或“发展计划”，“.md”是Markdown文件的扩展名 - 未来发展规划

技术文档

IMPLEMENTATION_STATUS.md 翻译为中文是：“实施状态.md”（注：这里的“.md”通常表示这是一个Markdown格式的文件，但在中文语境下，我们通常不会特别指出文件格式，除非上下文需要，所以“实施状态”即为文件名的核心部分） - 智能路由器的实现细节
SESSION_SUMMARY.md 翻译为中文是：会议总结.md - 最新的开发会议
docs/增强型路由器规范.md - 完整的路由器架构
docs/ARCHITECTURE_AND_CONNECTIONS.md 翻译为中文是：文档/架构与连接.md - 系统架构

功能文档

《智能港口管理.md》 - 港口分配系统
CONTEXT_OPTIMIZATION.md 翻译为中文是：“上下文优化.md” - 上下文缩减技术
《技能与客户准备情况.md》 - 技能与客户跟踪
TEST_LM_STUDIO_NOW.md 翻译为中文是：“测试LM_STUDIO当前状态.md” 或者 “LM_STUDIO现在测试报告.md”（具体翻译可能根据上下文有所调整，但核心意思是关于LM_STUDIO的测试文件）。不过，通常“md”是Markdown文档的扩展名，所以也可以直接翻译为“LM_STUDIO现在测试.md”，意为“LM_STUDIO的当前测试Markdown文档” - LM Studio测试指南
LM_STUDIO_MCP_SETUP_CORRECT.md 翻译为中文是：“LM_STUDIO_MCP_正确设置指南.md” 或者 “LM_STUDIO_MCP_配置正确方法.md”（具体翻译可能根据上下文和文档内容有所调整，但基本传达了原文的意思）。在这里，“.md”通常表示这是Markdown格式的文件，是一种轻量级的标记语言，用于编写结构化的文档 - LM Studio设置

历史文献

档案/存档/ - 旧会议记录和开发历史
存档/ARCHIVE_INDEX.md（或“档案/ARCHIVE_INDEX.md”，具体翻译取决于上下文中的“archive”是作为“存档”还是“档案”理解） - 存档文件索引

______________________________________________________________________

🐛 故障排除

集线器无法启动

检查先决条件：

node --version  # Should be 18+
npm --version   # Should be 9+

重建:

npm run build

服务器无法连接

检查日志:

logs/hub.log     # Main hub logs
logs/error.log   # Error logs

测试单个服务器：

# Test Blender server
blender --python path/to/blender-mcp/server.py

# Test Meshy server
cd external-servers/meshy-ai-mcp-server
python -m src.server

端口已被使用

集线器会自动查找可用端口（3100-3109）。如果所有端口都在使用中：

# Find process using port 3100
netstat -ano | findstr "3100"

# Kill process by PID
taskkill /PID 
 /F

LM Studio 连接问题

见 TEST_LM_STUDIO_NOW.md 以获取完整的故障排除指南。

______________________________________________________________________

📜 许可证

MIT 许可证 - 详见 LICENSE 文件

______________________________________________________________________

🙏 致谢

框架集成

人类技能 - 13项工作流程技能
GitHub Spec-Kit（可译为“GitHub规范工具包”或根据具体上下文调整为更贴切的名称） - 驱动规范（或需求）的开发框架
工厂人工智能（或工厂AI） - 代理模式架构

使用的MCP服务器

Obsidian MCP 工具 由 @colinschoen 提供
Blender MCP（可能指Blender的某种认证或会员计划，具体含义需根据上下文确定） 由@mcpblend（创建/发布）
Godot MCP 由@godot-mcp（创作/提供）
GitHub MCP（注：MCP在此处可能是一个特定项目、组织或概念的缩写，但没有具体上下文，因此直接翻译为“GitHub MCP”，在实际应用中可能需要根据具体含义进行调整）由 @github 提供
Meshy AI（可译为“梅希人工智能”或根据具体语境调整为更贴切的名称） 由@meshy（创作/提供）

使用（或构建于）...之上

TypeScript - 类型安全的开发
Node.js - 运行时环境
MCP SDK（MCP软件开发工具包） - 协议实现
快递 - 网络服务器
WebSocket（网络套接字） - 实时通信

______________________________________________________________________

📞 支持

问题:
讨论：
文档查看 docs/ 目录

______________________________________________________________________

🎯 快捷链接

创业中心: START_ALL.bat
图形用户界面仪表盘http://localhost:3100 翻译为中文是：“本地主机：3100 端口”。不过，通常我们不会直接这样翻译网址，而是会根据上下文解释为“访问本地开发服务器的网址，端口为3100”
MCP 端点http://localhost:3000/sse 翻译成中文可以是：“本地主机上的3000端口，路径为sse”。不过，通常在技术语境中，我们可能会直接保留网址的格式，因为网址本身已经具有明确的含义。但如果需要解释或说明，上述翻译是一个基本的表述
日志: logs/hub.log
配置： config/mcp-servers.json
文档: docs/

______________________________________________________________________

最后更新时间2025年10月22日\ 状态开发中的智能路由器助力生产就绪\ 下一个里程碑完成智能路由器第一阶段（剩余2小时）

Gamedev MCP Hub

快速接入

详细介绍

游戏开发MCP中心

🚀 快速入门

先决条件

安装与启动

🏗️ 建筑学

核心组件

连接的MCP服务器

🎯 功能特点

多客户端支持

智能路由器（70%完成）

技能系统

图形用户界面仪表盘

📁 项目结构

🔧 配置

环境变量

服务器配置

🧪 测试

使用LM Studio

使用Claude Desktop

📊 当前状态

实施进度

行之有效的方法 ✅

进行中 ⏳

🎓 使用示例

对于人工智能助手

技能使用

🗺️ 路线图

🤝 贡献（或“参与贡献”）

📚 文档

核心文档

技术文档

功能文档

历史文献

🐛 故障排除

集线器无法启动

服务器无法连接

端口已被使用

LM Studio 连接问题

📜 许可证

🙏 致谢

框架集成

使用的MCP服务器

使用（或构建于）...之上

📞 支持

🎯 快捷链接

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP