Skip to main content
Glama

PageDesignerMcp

MCP Server 平台 + 多领域 Agent 插件系统,面向天工 aPaaS 平台的 44 个业务域。

项目初心(最高约束)

本项目是能力层,不是 harness。 为外部 AI 客户端(opencode / Claude Desktop / Cursor 等)提供处理天工 aPaaS 平台业务问题的能力:工具 + 知识库 + 说明书,通过 MCP 协议消费。

项目   = 能力层(工具 + 知识库 + 说明书)
消费方 = 外部 AI 客户端(AI 在项目之外,是设计不是残缺)
协议   = MCP
价值   = 让任何 AI 客户端都能高效处理天工各业务域的问题

边界约束(所有开发必须遵守):

  1. 不是 Agent 运行时 / harness — 不做 LLM 接入、决策循环、上下文管理、运行时编排 DSL、运行时持久化

  2. 决策权在外部 — 编排是外部 AI 客户端的事,本项目不做自动编排

  3. 能力优先 — 新增能力(工具/知识/说明书)优先于运行时机制建设

  4. 契约稳定 — Domain Contract / VCSClient 接口一旦发布,只增不减,保证外部 AI 客户端持续可用

Related MCP server: gitlab-api

架构

opencode.json
  └── domains/AGENTS.md          ← 主路由(唯一入口)
        ├── page/                ← 页面设计器
        ├── report/              ← 报表
        ├── saas/                ← SaaS 多租户
        ├── flow/                ← 流程
        ├── approval/            ← 审批
        ├── ...                  ← 共 44 个业务域
        └── databack-rt/         ← 数据回写运行时

每个域包含:index.js(工具)、AGENTS.md(行为)、knowledge/(知识库)

平台结构:src/core/(加载机制:注册表/加载器/工厂)+ src/tools/(平台内置工具)+ shared-skills/(跨域技能包)+ config/(域配置与技能注册)。新增能力见 ARCHITECTURE.md §2.3 决策树。

快速启动

npm install
node src/index.js

环境变量(集中凭据,.env 文件,已被 gitignore)

复制 .env.example 为 .env 并填入真实值。所有凭据集中在此:

变量

用途

必选

GITLAB_TOKEN

GitLab 代码搜索/诊断

✅

GITLAB_URL

GitLab 实例地址

可选

ARCHERY_USERNAME / ARCHERY_PASSWORD

数据库查询(shared_db_query)

用 db_query 时

SSO_USERNAME / SSO_PASSWORD

阿里云日志查询(shared_aliyun_query_log)

用日志查询时

⚠️ 内网技能需先连接公司 VPN:Archery / 阿里云 SLS 均为内网服务,未连 VPN 会报 ERR_NAME_NOT_RESOLVED 或卡在连接。

📄 完整凭据清单、读取优先级、换机步骤见 docs/credentials.md。

脚本

命令

说明

npm start

启动 MCP Server

npm test

运行测试

npm run create-domain <name>

创建新领域脚手架

文档

  • ARCHITECTURE.md — 完整架构设计

  • domains/AGENTS.md — 主路由表(44 域)

  • domains/page/knowledge/README.md — 知识库导航(315 篇)

Available Tools

11 tools
diagnose_errorB

诊断错误码/错误名,在 GitLab 代码库中搜索引用和抛出位置

Inputs: errorCode, errorName.

diagnose_frontendC

诊断前端渲染/Store/组件加载等问题 (通过 GitLab 搜索)

Inputs: symptom (required).

gitlab_get_fileB

从 GitLab 读取文件内容

Inputs: filePath (required), raw, ref, project.

gitlab_list_mrsC

查询 GitLab 项目 Merge Request 列表

Inputs: state, project, maxResults.

gitlab_search_codeC

在 GitLab 项目中全局搜索代码 (通用)

Inputs: query (required), project, filePath, maxResults.

parse_stacktraceB

解析Java异常堆栈,提取错误码和源码位置

Inputs: stack (required).

query_dbtableB

查询数据库表的实体类字段定义 (通过 GitLab)

Inputs: tableName (required).

query_knowledgeC

搜索整个页面设计器知识库

Inputs: query (required).

recommend_configC

根据页面描述推荐页面类型、组件骨架和增强功能

Inputs: intent (required).

trace_callchainC

追踪类/方法的调用链 (通过 GitLab 搜索)

Inputs: className, methodName.

trace_callgraphA

追踪调用层级图:Controller→Service→Handler→Mapper (通过 GitLab)

Inputs: className (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 11 tools

    Disambiguation4/5

    Tools are mostly distinct with clear purposes, though some overlap in GitLab search usage (e.g., trace_callchain and gitlab_search_code both perform code searches, but for different intents).

    Naming Consistency5/5

    All tools use a consistent snake_case verb_noun pattern (e.g., recommend_config, parse_stacktrace, gitlab_list_mrs). No mixing of styles.

    Tool Count5/5

    11 tools cover a focused set of debugging and knowledge tasks without being overwhelming. Each tool serves a clear purpose within the server's scope.

    Completeness2/5

    The server lacks core page design capabilities beyond a recommendation tool. Missing operations for creating, editing, or managing page designs, which is a significant gap for a 'PageDesigner' server.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that distributes tool specifications from GitLab repositories to IDEs, dynamically generating MCP tools and serving files via aimcp:// URIs.
      25 PyPI
      MIT