鸣潮 MCP Server

一个 Model Context Protocol (MCP) 服务器，用于获取《鸣潮》游戏的角色和声骸信息，并以 Markdown 格式返回，方便大型语言模型使用。

📄

🚀 最新更新 (v2.0.1)

• 🏗️ 架构重构：采用领域驱动设计（DDD）架构，清晰的分层结构

• 🔧 代码质量：集成 ruff 代码格式化和静态分析工具

• 📝 现代化语法：使用 Python 3.12+ 现代类型注解 (dict/list 替代 Dict/List)

• 🧹 代码清理：移除旧有代码，统一代码风格和质量标准

• ✅ 支持 Streamable HTTP 传输：支持 Smithery 的新 HTTP 传输协议

• 🔄 向后兼容：同时支持传统的 STDIO 和新的 HTTP 传输模式

• 🌐 云端部署就绪：完美适配 VPS、Google Cloud Run、AWS Lambda 等云环境

• 📦 依赖注入：使用依赖注入容器管理服务实例

• 🐳 Docker 优化：使用 uv 的多阶段构建，提升构建速度并减小镜像体积

功能特点

• 角色信息查询：获取《鸣潮》游戏中角色的详细信息

• 声骸信息查询：获取《鸣潮》游戏中声骸套装的详细信息

• 角色档案查询：获取《鸣潮》游戏中角色的档案信息

• LLM 友好输出：结果格式特别为大型语言模型优化

• 双传输模式：支持 STDIO 和 Streamable HTTP 传输

安装方法

通过 Smithery 安装

要通过 Smithery 自动安装 WuWa MCP Server：

通过 uv 安装

直接从 PyPI 安装：

使用方法

与 Cherry Studio 一起运行

1. 下载 Cherry Studio

2. 在设置中点击 MCP 服务器

添加以下配置：

与 Claude Desktop 一起运行

1. 下载 Claude Desktop

2. 创建或编辑您的 Claude Desktop 配置文件：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\\Claude\\claude_desktop_config.json

添加以下配置：

3. 重启 Claude Desktop

可用工具

1. 角色信息工具

在库街区上查询角色详细信息并以 Markdown 格式返回。

参数：

• character_name: 要查询的角色的中文名称

返回： 包含角色信息的 Markdown 字符串，或者在找不到角色或获取数据失败时返回错误消息。

2. 声骸信息工具

在库街区上查询声骸详细信息并以 Markdown 格式返回。

参数：

• artifact_name: 要查询的声骸套装的中文名称

返回： 包含声骸信息的 Markdown 字符串，或者在找不到声骸或获取数据失败时返回错误消息。

3. 角色档案工具

在库街区上查询角色档案信息并以 Markdown 格式返回。

参数：

• character_name: 要查询的角色的中文名称

返回： 包含角色档案信息的 Markdown 字符串，或者在找不到角色或获取数据失败时返回错误消息。

开发和测试

本地运行

代码质量

项目使用 ruff 进行代码格式化和静态分析，确保代码质量和一致性。

安装开发依赖

代码格式化和检查

Ruff 配置

项目配置了以下代码质量规则：

• 行长度: 120 字符

• 目标 Python 版本: 3.12

• 启用规则: pycodestyle、pyflakes、isort、命名约定、pyupgrade、bugbear、代码简化等

• Import 排序: 强制单行导入，项目模块优先级设置

Docker 部署

详细功能

结果处理

• 清理和格式化库街区数据

• 为 LLM 消费优化格式

• 支持并行处理提高性能

• 异步操作避免阻塞

传输模式

• STDIO 传输：适用于本地客户端，如 Claude Desktop

• Streamable HTTP 传输：适用于云端部署和远程访问

• 自动检测环境变量 TRANSPORT 切换模式

贡献

欢迎提出问题和拉取请求！一些潜在的改进领域：

• 增加对更多《鸣潮》游戏内容的支持

• 增强内容解析选项

• 增加对频繁访问内容的缓存层

• 支持更多语言的本地化

许可证

本项目采用 MIT 许可证。