MCP Server

BasicApp 没有自己的 MCP 服务端：后端与前端分别接入 XiHan.Framework 与 XiHan.UI 的服务端，AI 写后端代码时查框架的包、模块与配置键，写前端代码时查组件的 API、示例与令牌。两者都随包离线发布，按项目引用的版本钉住。

服务端	由谁提供	管什么	文档
`xihan-framework`	.NET 工具 `XiHan.Framework.Cli`	包与模块类、`[DependsOn]`、包依赖、配置节的属性与缺省值、框架文档	框架的 MCP Server
`xihan-ui`	npm 包 `@xihan-ui/cli`	组件 API、部件与样式钩子、三种写法的示例、设计令牌、design.md	组件库的 MCP Server

用 setup 写入

在仓库根运行。两条命令分别扫描 backend/ 的项目文件与 frontend/ 的依赖读出版本，写进仓库根同一个配置文件，各自只改自己那一项：

bash

dnx XiHan.Framework.Cli --yes -- setup --client claude    # 写 xihan-framework，并写入框架技能
npx -y @xihan-ui/cli setup --client claude                # 写 xihan-ui，并写入组件库技能

--client 可换成 cursor（.cursor/mcp.json）、vscode（.vscode/mcp.json）或 codex（打印 ~/.codex/config.toml 片段）。只要 MCP 配置不要技能时加 --mode mcp；加 --dry-run 只打印不写文件，加 --check 核对配置是否就绪。需要 .NET 10 SDK（dnx）与 Node ≥ 18（npx）。

手写配置

仓库根的 .mcp.json（Claude Code）或 .cursor/mcp.json（Cursor）：

json

{
  "mcpServers": {
    "xihan-framework": {
      "command": "dnx",
      "args": ["XiHan.Framework.Cli@<框架版本>", "--yes", "--", "mcp"]
    },
    "xihan-ui": {
      "command": "npx",
      "args": ["-y", "@xihan-ui/cli@<组件库版本>", "mcp"]
    }
  }
}

两个版本号分别取自：

版本	从哪里看
框架版本	`backend/` 下各项目文件里 `XiHan.Framework.*` 的 `Version`
组件库版本	`frontend/pnpm-workspace.yaml` 的 catalog 里 `@xihan-ui/vue` 的版本

Windows（非 WSL）上 Claude Code 需要经 cmd /c 调用 dnx 与 npx：把 command 写成 cmd，args 前面加上 "/c" 与原来的命令名，setup --client claude 会自动这样写。VS Code 的 .vscode/mcp.json 顶层键是 servers，每一项再加 "type": "stdio"。

MCP Server ​

用 setup 写入 ​

手写配置 ​

相关 ​

MCP Server

用 setup 写入

手写配置

相关