CobbleSeer-MCP-Server

JX-YL/CobbleSeer-MCP-Server

3.2

If you are the rightful owner of CobbleSeer-MCP-Server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

CobbleSeer MCP Server is an AI-driven backend service designed to facilitate the generation of Cobblemon resource packs using the Model Context Protocol (MCP).

Tools
6
Resources
0
Prompts
0

CobbleSeer MCP Server

AI驱动的Cobblemon资源包生成器 - MCP Server后端

📖 简介

这是一个基于 MCP (Model Context Protocol) 的后端服务，为Cobblemon资源包生成提供智能工具支持。

核心功能

  • 🎯 创建宝可梦：自动生成完整的species/spawn/poser/resolver文件
  • 🤖 AI生成技能：基于自然语言描述生成Showdown格式技能代码
  • 🔮 AI生成特性：智能生成特性JavaScript代码
  • 📚 RAG检索：自动从参考库检索相似内容
  • ✅ 文件验证：JSON Schema验证确保文件正确性
  • 📦 资源包构建：生成文件夹格式数据包（自动检测依赖）
  • 🎯 规则引擎生成技能：无需AI，零配置，100%准确

🏗️ 技术栈

  • 框架: fastmcp (简化的MCP实现)
  • Web Server: FastAPI + uvicorn
  • AI: Claude API (云端) / Ollama (本地可选)
  • RAG: ChromaDB + sentence-transformers
  • 数据库: SQLite (项目数据)
  • 验证: Pydantic + JSON Schema

📂 项目结构

cobblemon_mcp_server/
├── server.py                    # fastmcp主入口
├── config.yaml                  # 配置文件
├── requirements.txt             # Python依赖
├── pyproject.toml              # 项目配置
│
├── services/                    # 核心服务
│   ├── __init__.py
│   ├── ai_generator.py         # AI生成服务（混合模式）
│   ├── rag_service.py          # RAG检索服务
│   ├── builder.py              # 文件构建服务
│   └── validator.py            # 文件验证服务
│
├── models/                      # 数据模型
│   ├── __init__.py
│   ├── pokemon.py              # 宝可梦数据模型
│   └── schemas.py              # JSON Schema定义
│
├── utils/                       # 工具函数
│   ├── __init__.py
│   ├── logger.py               # 日志工具
│   └── helpers.py              # 辅助函数
│
└── data/                        # 运行时数据（.gitignore）
    ├── chroma_db/              # 向量数据库
    ├── projects.db             # 项目数据库
    └── cache/                  # 缓存目录

🚀 快速开始

1. 环境要求

  • Python 3.11+
  • (可选) Ollama（如需本地AI）

2. 安装依赖

cd Cobblemon_mcp_server
pip install -r requirements.txt

3. 配置

首次运行会自动创建 config.yaml，或手动编辑：

ai:
  mode: "cloud"  # cloud | local | hybrid
  cloud:
    api_key: "your-api-key"
    model: "claude-3-5-sonnet-20241022"

4. 启动服务

stdio模式（Cursor调用）：

python server.py

HTTP模式（Web UI调用）：

python server.py --http

🔧 MCP工具列表

1. create_pokemon

创建完整的宝可梦配置文件

输入：

{
  "name": "example_pokemon",
  "dex": 10001,
  "primary_type": "Fire",
  "stats": {"hp": 80, "attack": 90, ...}
}

输出：

{
  "success": true,
  "files": {
    "species": {...},
    "spawn": {...},
    "poser": {...}
  }
}

2. generate_moves

AI生成技能代码

输入：

{
  "descriptions": [
    "火系物理攻击，威力90，命中100，有10%几率灼伤"
  ]
}

输出：

[
  {
    "description": "...",
    "code": "{ num: -10001, ... }",
    "valid": true
  }
]

3. generate_abilities

AI生成特性代码

4. search_reference

从参考库搜索相似内容

5. validate_package

验证生成的文件

6. build_package

构建资源包（文件夹格式，自动检测依赖模组）

7. create_move

创建自定义技能（规则引擎，零配置）

8. create_move_with_template

使用AI模板生成技能

🤖 AI模式说明

云端模式（推荐）

  • ✅ 无硬件要求
  • ✅ 速度快（5-10秒）
  • ✅ 质量高（95%）
  • 💰 需要API Key

本地模式

  • ⚠️ 需要32GB+运存
  • ⚠️ 速度慢（15-25秒）
  • ✅ 完全离线
  • ✅ 无API成本

混合模式

  • ✅ 智能切换
  • ✅ 简单任务用本地
  • ✅ 复杂任务用云端

📝 配置文件示例

# config.yaml
ai:
  mode: "hybrid"
  
  cloud:
    provider: "claude"
    api_key: "${COBBLESEER_API_KEY}"
    model: "claude-3-5-sonnet-20241022"
  
  local:
    model: "qwen3:7b"
    embedding_model: "qwen3-embedding"
    ollama_host: "http://localhost:11434"

rag:
  enabled: true
  collection_name: "cobblemon_reference"
  top_k: 5

database:
  url: "sqlite:///data/projects.db"

server:
  host: "127.0.0.1"
  port: 8765
  cors_origins: ["http://localhost:5173"]

🔍 开发调试

查看日志

python server.py --debug

测试单个工具

# test.py
from server import mcp
import asyncio

async def test():
    result = await mcp.tools["create_pokemon"](
        name="test_mon",
        dex=99999,
        primary_type="Fire",
        stats={"hp": 100, "attack": 100}
    )
    print(result)

asyncio.run(test())

✨ 最新优化 (v1.1.0)

1. 移除压缩包功能

  • ✅ 只生成文件夹格式：Minecraft支持直接使用文件夹作为数据包
  • ✅ 更快的生成速度：无需压缩步骤
  • ✅ 更方便调试：可以直接查看和修改生成的文件
  • ✅ 避免编码问题：Windows压缩容易出现路径/编码错误

2. 智能依赖检测

  • 🎯 自动识别所需模组：
    • 基础宝可梦 → 只需 Cobblemon
    • 自定义技能/特性 → 需要 Cobblemon + Mega Showdown
  • 📝 清晰的README：自动在生成的README中标注所需模组
  • ⚠️ 醒目提示：如果需要额外模组，会在文档中高亮提示

3. 统一架构设计

  • ✨ 单一版本：无需在"基础版"/"完整版"之间选择
  • 🔄 平滑升级：从原版功能自然过渡到扩展功能
  • 🛠️ 维护简单：只需维护一套代码

4. 优化的输出结构

Testmon_Complete_DataPack/
├── README.md                         # 包含依赖信息和使用说明
├── pack.mcmeta
├── data/
│   ├── cobblemon/                    # 原版兼容
│   └── mega_showdown/                # 扩展功能（如果有）
└── assets/
    └── cobblemon/

📚 相关文档

🤝 贡献

这是 江下犹泷 的项目，欢迎反馈和建议！

📄 许可

MIT License

制作者：江下犹泷
最后更新：2025.10.17