原神千星奇境教程 MCP 服务器

专门为《原神》千星奇境地图编辑器设计的 MCP（模型上下文协议）服务器，提供对官方教程和节点文档的实时访问。

核心功能

🗺️ 导航目录查询

• 获取完整的官方教程结构
• 支持按类别浏览所有可用教程
• 提供详细的教程ID和链接

📊 节点图查询系统

• 客户端节点 查询节点、操作节点、执行节点、过程控制节点、其他节点
• 服务端节点 执行节点、事件节点、过程控制节点、查询节点、计算节点
• 智能缓存机制提高查询效率
• 按功能分类组织节点列表

📋 详细文档获取

• 完整显示节点参数表
• 详细描述输入和输出参数
• 使用示例和配置指南
• 原始链接和参考信息

Cherry Studio 配置指南

环境要求

• Cherry Studio （支持 MCP 协议的 AI 客户端）

1. 获取 MCP 服务器

下载预编译版本（推荐）

1. 访问项目发布页面：https://github.com/用户名/genshin-starcraft-mcp/releases
2. 下载适用于您操作系统的最新版本
   • Windows: genshin-starcraft-mcp-windows.exe
   • Linux: genshin-starcraft-mcp-linux
   • macOS: genshin-starcraft-mcp-macos
3. 将可执行文件放置在适当位置

2. Cherry Studio 配置

Cherry Studio 配置步骤

1. 打开 Cherry Studio 设置
2. 查找 MCP 服务器配置
3. 添加新的 MCP 服务器：

   名称: 原神千星奇境教程
   命令: /path/to/your/genshin-starcraft-mcp
   

   • Windows: C:\path\to\genshin-starcraft-mcp-windows.exe
   • Linux/macOS: /path/to/genshin-starcraft-mcp-linux
4. 创建新的助手 turnprompt 或 简化版提示词 填写提示词设置

3. 验证配置

创建聊天并询问助手：如何给玩家添加技能

技术特性

• Go + rod 高性能无头浏览器操作，支持复杂的页面交互
• MCP 协议 基于标准 MCP 协议，兼容多个 AI 客户端
• 智能缓存 节点查询结果缓存显著提高查询效率
• 结构化数据 完整的参数表和输入/输出指令
• 实时更新 直接访问官方教程网站以获取最新信息

常见问题

经常遇到的问题

1. Cherry Studio 无法连接

• 确认 MCP 服务器正在运行
• 检查配置文件中的路径是否正确
• 尝试重启 Cherry Studio

2. 查询没有结果

• 检查网络连接
• 确认参数名称是否正确
• 查看服务器日志输出

调试模式

启用调试日志并添加：

DEBUG=1

然后，在 MCP 同一目录下会生成 genshin-starcraft-mcp.log 文件

自编译（仅限开发者）

# 克隆项目
git clone <项目地址>
cd genshin-starcraft-mcp

# 安装依赖
go mod tidy

# 构建服务器
go build -o genshin-starcraft-mcp cmd/server/main.go

运行测试

配置完成后，启动 MCP 服务器进行测试：

# Windows
./genshin-starcraft-mcp-windows.exe

# Linux
./genshin-starcraft-mcp-linux

# macOS
./genshin-starcraft-mcp-macos

项目架构

genshin-starcraft-mcp/
├── cmd/
│   └── server/
│       └── main.go           # 服务器启动入口
├── pkg/
│   ├── mcp/
│   │   └── server.go         # MCP服务器核心实现
│   ├── scraper/              # 网页抓取模块
│   │   ├── browser.go        # 浏览器控制和导航
│   │   ├── search.go         # 搜索功能实现
│   │   └── node.go           # 节点查询和处理
│   ├── models/               # 数据模型定义
│   │   └── tutorial.go       # 教程和节点数据结构
│   └── utils/
│       └── logger.go         # 日志工具
├── cherry_studio_prompt.txt  # Cherry Studio 提示词
├── assistant_prompt.md       # 通用助手提示词
├── go.mod
├── go.sum
└── README.md

许可证

MulanPSL2 许可证