Design plan for Claude MCP skill compatibility #171

Copilot · 2026-01-05T08:52:58Z

Claude Skill/MCP 兼容性实现

MCP 实现已完成 ✅

Phase 1-7: MCP 完整实现
- MCP 核心数据类型、转换器、渲染器、注册表
- JSON-RPC 协议处理、传输层 (SSE/stdio)
- REST API 端点、异步工具执行器
- 120+ 单元测试全部通过

Claude Skills 实现已完成 ✅

新增文件

pulsar-core/pulsar-agentic/src/main/kotlin/ai/platon/pulsar/agentic/
├── mcp/
│   ├── MCPTypes.kt          # MCP 数据类型
│   ├── MCPToolConverter.kt  # 工具转换器
│   ├── MCPToolRenderer.kt   # JSON 渲染器
│   ├── MCPToolRegistry.kt   # 工具/资源/提示注册表
│   ├── MCPProtocol.kt       # JSON-RPC 协议处理
│   ├── MCPTransport.kt      # SSE/stdio 传输层
│   └── MCPToolExecutor.kt   # 异步工具执行器
└── skills/
    ├── SkillTypes.kt        # Claude Skill 数据类型
    ├── SkillGenerator.kt    # 技能生成器
    ├── SkillRegistry.kt     # 技能注册表
    └── SkillRenderer.kt     # 技能导出渲染器

pulsar-rest/src/main/kotlin/ai/platon/pulsar/rest/api/
├── service/
│   ├── MCPService.kt        # MCP 服务层
│   └── SkillService.kt      # Skills 服务层
└── controller/
    ├── MCPController.kt     # MCP REST API
    ├── MCPSSEController.kt  # MCP SSE 传输
    └── SkillController.kt   # Skills REST API

使用示例

# MCP 工具列表
curl http://localhost:8182/api/mcp/tools

# 技能列表
curl http://localhost:8182/api/skills

# 导出 Claude Desktop 配置
curl http://localhost:8182/api/skills/export/claude-desktop > skills.json

Security Summary

代码审查已完成，无安全漏洞。修复了一处未使用的导入。

Original prompt

重新设计 claude skill 兼容的功能。第一步先给计划让我审核。

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

galaxyeye · 2026-01-05T11:27:44Z

@copilot MCP 工具是否需要支持异步执行？- 需要
是否需要支持 MCP 的 resource 概念？- 需要
是否需要实现完整的 MCP server 协议？- 需要

Copilot · 2026-01-05T11:29:19Z

@copilot MCP 工具是否需要支持异步执行？- 需要
是否需要支持 MCP 的 resource 概念？- 需要
是否需要实现完整的 MCP server 协议？- 需要

已更新设计计划，纳入以下确认需求：

异步执行支持 - Phase 4.4 新增 coroutine-based 异步执行
Resource 概念 - Phase 1.4 新增 MCPResource 数据类，Phase 3.4 新增 MCPResourceRegistry，Phase 5.4 实现 resources/list / resources/read
完整 MCP Server 协议 - Phase 5 扩展为完整协议实现，包括 JSON-RPC 传输层、握手、工具/资源/提示模板方法、通知机制

计划已从 6 阶段扩展为 7 阶段，确认后开始实现。

galaxyeye · 2026-01-05T11:44:52Z

@copilot 开始实现。

…nd protocol handler Co-authored-by: galaxyeye <1701451+galaxyeye@users.noreply.github.com>

Copilot · 2026-01-05T12:01:39Z

@copilot 开始实现。

已开始实现。首批代码已提交 (43ad9c6)，包含：

已完成 (Phase 1-4):

MCP 核心数据类型 (MCPTypes.kt) - 工具/资源/提示/协议消息定义
转换器 (MCPToolConverter.kt) - Kotlin ↔ JSON Schema 双向转换
渲染器 (MCPToolRenderer.kt) - JSON 序列化
注册表 (MCPToolRegistry.kt) - 统一管理工具/资源/提示
JSON-RPC 协议处理器 (MCPProtocol.kt) - 实现完整 MCP 协议方法

测试: 75 个单元测试全部通过

待完成:

Phase 5: MCP Server 传输层 (stdio/SSE)
Phase 6: REST API 暴露
与 AgentToolManager 的异步执行集成

…ix template matching Co-authored-by: galaxyeye <1701451+galaxyeye@users.noreply.github.com>

galaxyeye · 2026-01-05T14:53:35Z

@copilot 继续

…ensive tests Co-authored-by: galaxyeye <1701451+galaxyeye@users.noreply.github.com>

Copilot · 2026-01-05T15:06:51Z

@copilot 继续

已继续实现 Phase 6 REST API (c456b84):

新增:

MCPService - MCP 操作服务层
MCPController - REST API 控制器，提供 13 个端点:
- 工具: /api/mcp/tools, /api/mcp/tools/domain/{domain}, /api/mcp/tools/{name}, /api/mcp/tools/call
- 资源: /api/mcp/resources, /api/mcp/resources/templates, /api/mcp/resources/read
- 提示: /api/mcp/prompts, /api/mcp/prompts/{name}
- 服务器: /api/mcp/capabilities, /api/mcp/info, /api/mcp/stats
- JSON-RPC: /api/mcp/rpc
MCPControllerTest - 16 个单元测试全部通过

总测试数: 91 个 (pulsar-agentic: 75 + pulsar-rest: 16)

待完成:

Phase 5: MCP Server 传输层 (stdio/SSE)
与 AgentToolManager 的完整异步执行集成

galaxyeye · 2026-01-05T15:09:07Z

@copilot 继续

Co-authored-by: galaxyeye <1701451+galaxyeye@users.noreply.github.com>

Copilot · 2026-01-05T15:22:16Z

@copilot 继续

已继续实现 Phase 5 MCP Server 传输层 (52c7bda):

新增:

MCPTransport.kt - SSE 和 stdio 传输层
- MCPSSESession - SSE 会话管理与事件流
- MCPSSESessionManager - 会话生命周期管理与自动清理
- MCPStdioTransport - 命令行集成的 stdio 传输
- MCPServer / MCPServerInstance - 统一服务器入口
MCPSSEController.kt - SSE REST 端点
- GET /api/mcp/sse/connect - 建立 SSE 连接
- POST /api/mcp/sse/message - 发送消息
- POST /api/mcp/sse/disconnect - 断开连接
- GET /api/mcp/sse/session/{id} - 会话信息
- GET /api/mcp/sse/sessions - 列出会话
- GET /api/mcp/sse/stats - 传输统计
MCPTransportTest.kt - 17 个单元测试

总测试数: 108 个 (全部通过)

待完成:

与 AgentToolManager 的完整异步执行集成
集成测试和文档

galaxyeye · 2026-01-05T15:25:10Z

@copilot 继续

Co-authored-by: galaxyeye <1701451+galaxyeye@users.noreply.github.com>

Copilot · 2026-01-05T15:42:18Z

@copilot 继续

已继续实现 Phase 4.4 异步工具执行集成 (c291d82):

新增:

MCPToolExecutor.kt - MCP 异步工具执行器
- 与 AgentToolManager 集成
- 工具调用验证 (validate())
- 工具帮助信息 (getHelp())
- 支持 coroutine-based 异步执行
MCPToolExecutorTest.kt - 12 个单元测试
MCPToolConverter.kt 改进：
- 支持合并同名但签名不同的工具（如 driver.click 有多个重载）
- 所有重载都有的参数为 required，部分重载才有的参数为 optional
MCPController.kt 新端点：
- POST /api/mcp/tools/validate - 验证工具调用
- GET /api/mcp/tools/{name}/help - 获取工具帮助

总测试数: 120+ 个 (全部通过)

完成进度:

Phase 1-6 全部完成 ✅
待完成: 集成测试、E2E 测试、文档

galaxyeye · 2026-01-06T02:48:25Z

@copilot 支持 Claude Skills，先制定计划

Copilot · 2026-01-06T02:51:13Z

@copilot 支持 Claude Skills，先制定计划

Claude Skills 支持计划

背景

Claude Skills 是 Claude 的可重用能力单元，允许用户定义自定义技能并在对话中调用。Browser4 需要支持将现有工具导出为 Claude Skills 格式。

与 MCP 的关系

MCP = 协议层 (通信方式)
Claude Skills = 能力定义层 (技能格式)

当前 MCP 实现已完成通信协议，现需添加 Skills 格式支持。

Phase 1: Skills 数据结构 (`pulsar-agentic/skills`)

1.1 ClaudeSkill - 技能定义

data class ClaudeSkill(
    val name: String,           // 技能名称
    val description: String,    // 技能描述
    val instructions: String,   // 使用说明
    val tools: List<ClaudeSkillTool>,  // 可用工具
    val examples: List<SkillExample>?, // 使用示例
    val metadata: SkillMetadata?       // 元数据
)

1.2 ClaudeSkillTool - 技能工具定义 (基于 MCP tool schema)
1.3 SkillExample - 使用示例
1.4 SkillMetadata - 技能元数据 (版本/作者/标签)

Phase 2: 技能生成器 (`SkillGenerator.kt`)

2.1 从 MCP 工具生成技能
- generateFromMCPTools() - 批量转换
- generateBrowserSkill() - 浏览器自动化技能
- generateExtractionSkill() - 数据提取技能
2.2 技能模板系统
- 预定义模板: 网页浏览、表单填写、数据提取
- 自定义模板支持
2.3 自动生成使用说明和示例

Phase 3: 预置技能库 (`built-in-skills/`)

3.1 WebBrowsingSkill - 网页浏览技能

包含: navigateTo, click, fill, scroll 等工具
示例: 搜索、导航、表单操作

3.2 DataExtractionSkill - 数据提取技能

包含: extract, summarize, textContent 等工具
示例: 提取商品信息、文章摘要

3.3 FormAutomationSkill - 表单自动化技能

包含: fill, check, select, submit 等工具
示例: 登录、注册、表单提交

3.4 FileOperationSkill - 文件操作技能

Phase 4: Skills 导出格式

4.1 JSON 格式导出
4.2 YAML 格式导出 (Claude Desktop 配置)
4.3 Claude Desktop skills.json 格式
4.4 可分享的技能包 (zip/tarball)

Phase 5: Skills 管理

5.1 SkillRegistry - 技能注册表
5.2 技能版本管理
5.3 技能依赖解析

Phase 6: REST API 扩展 (`pulsar-rest`)

6.1 GET /api/skills - 列出所有技能
6.2 GET /api/skills/{name} - 获取技能详情
6.3 GET /api/skills/{name}/export - 导出技能
6.4 POST /api/skills - 创建自定义技能
6.5 GET /api/skills/templates - 获取技能模板

Phase 7: 测试与文档

7.1 单元测试
7.2 导出格式验证测试
7.3 Claude Desktop 集成文档
7.4 技能开发指南

预期输出示例

Claude Desktop skills.json:

{
  "skills": [
    {
      "name": "web_browsing",
      "description": "Browse and interact with web pages",
      "instructions": "Use this skill to navigate websites, click elements, fill forms...",
      "tools": [
        {
          "name": "driver.navigateTo",
          "description": "Navigate to a URL",
          "inputSchema": { ... }
        }
      ],
      "examples": [
        {
          "input": "Go to google.com and search for 'AI news'",
          "steps": ["driver.navigateTo('https://google.com')", "driver.fill('#search', 'AI news')", "driver.click('#submit')"]
        }
      ]
    }
  ]
}

请确认此计划后开始实现。

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

docs.anthropic.com
- Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node /home/REDACTED/work/_temp/ghcca-node/node/bin/node --enable-source-maps /home/REDACTED/work/_temp/copilot-developer-action-main/dist/index.js (dns block)
support.anthropic.com
- Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node /home/REDACTED/work/_temp/ghcca-node/node/bin/node --enable-source-maps /home/REDACTED/work/_temp/copilot-developer-action-main/dist/index.js (dns block)
www.anthropic.com
- Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node /home/REDACTED/work/_temp/ghcca-node/node/bin/node --enable-source-maps /home/REDACTED/work/_temp/copilot-developer-action-main/dist/index.js (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Configure Actions setup steps to set up my environment, which run before the firewall is enabled
Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

galaxyeye · 2026-01-06T06:34:52Z

@copilot 开始实现

…, and REST API (Phase 1-6) Co-authored-by: galaxyeye <1701451+galaxyeye@users.noreply.github.com>

Copilot · 2026-01-06T06:47:24Z

@copilot 开始实现

已完成 Claude Skills 实现 (e4a23e6)：

新增功能:

5 个预置技能: web_browsing, form_automation, data_extraction, file_operations, system
技能生成器支持自定义技能创建
多格式导出: JSON, YAML, Claude Desktop, MCP, Markdown
16 个 REST API 端点 (/api/skills/*)
49 个单元测试全部通过

使用示例:

# 导出 Claude Desktop 配置
curl http://localhost:8182/api/skills/export/claude-desktop > skills.json

Co-authored-by: galaxyeye <1701451+galaxyeye@users.noreply.github.com>

Initial plan

dea84dc

Copilot AI assigned Copilot and galaxyeye Jan 5, 2026

Copilot started work on behalf of galaxyeye January 5, 2026 08:53 View session

Copilot AI changed the title ~~[WIP] Redesign Claude skill compatibility features~~ Design plan for Claude MCP skill compatibility Jan 5, 2026

Copilot AI requested a review from galaxyeye January 5, 2026 08:56

Copilot finished work on behalf of galaxyeye January 5, 2026 08:56

Copilot started work on behalf of galaxyeye January 5, 2026 11:28 View session

Copilot finished work on behalf of galaxyeye January 5, 2026 11:30

Copilot started work on behalf of galaxyeye January 5, 2026 11:45 View session

Implement Phase 1-5: MCP core types, converter, renderer, registry, a…

43ad9c6

…nd protocol handler Co-authored-by: galaxyeye <1701451+galaxyeye@users.noreply.github.com>

Address code review feedback: improve documentation, add TODOs, and f…

b05600c

…ix template matching Co-authored-by: galaxyeye <1701451+galaxyeye@users.noreply.github.com>

Copilot finished work on behalf of galaxyeye January 5, 2026 12:06

Copilot started work on behalf of galaxyeye January 5, 2026 14:54 View session

Add MCP REST API endpoints: MCPService and MCPController with compreh…

c456b84

…ensive tests Co-authored-by: galaxyeye <1701451+galaxyeye@users.noreply.github.com>

Copilot finished work on behalf of galaxyeye January 5, 2026 15:08

Copilot started work on behalf of galaxyeye January 5, 2026 15:09 View session

Add MCP Server transport layer with SSE and stdio support (Phase 5)

52c7bda

Co-authored-by: galaxyeye <1701451+galaxyeye@users.noreply.github.com>

Copilot finished work on behalf of galaxyeye January 5, 2026 15:23

Copilot started work on behalf of galaxyeye January 5, 2026 15:25 View session

Add MCPToolExecutor for async tool execution integration (Phase 4.4)

c291d82

Co-authored-by: galaxyeye <1701451+galaxyeye@users.noreply.github.com>

Copilot finished work on behalf of galaxyeye January 5, 2026 15:44

Copilot started work on behalf of galaxyeye January 6, 2026 02:49 View session

Copilot finished work on behalf of galaxyeye January 6, 2026 02:52

Copilot started work on behalf of galaxyeye January 6, 2026 06:35 View session

Implement Claude Skills support: types, generator, registry, renderer…

e4a23e6

…, and REST API (Phase 1-6) Co-authored-by: galaxyeye <1701451+galaxyeye@users.noreply.github.com>

Fix unused import in SkillTypesTest

5e3e125

Co-authored-by: galaxyeye <1701451+galaxyeye@users.noreply.github.com>

Copilot finished work on behalf of galaxyeye January 6, 2026 06:49

Design plan for Claude MCP skill compatibility #171

Are you sure you want to change the base?

Design plan for Claude MCP skill compatibility #171

Uh oh!

Conversation

Copilot AI commented Jan 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Claude Skill/MCP 兼容性实现

MCP 实现已完成 ✅

Claude Skills 实现已完成 ✅

新增文件

使用示例

Security Summary

Uh oh!

galaxyeye commented Jan 5, 2026

Uh oh!

Copilot AI commented Jan 5, 2026

Uh oh!

galaxyeye commented Jan 5, 2026

Uh oh!

Copilot AI commented Jan 5, 2026

Uh oh!

galaxyeye commented Jan 5, 2026

Uh oh!

Copilot AI commented Jan 5, 2026

Uh oh!

galaxyeye commented Jan 5, 2026

Uh oh!

Copilot AI commented Jan 5, 2026

Uh oh!

galaxyeye commented Jan 5, 2026

Uh oh!

Copilot AI commented Jan 5, 2026

Uh oh!

galaxyeye commented Jan 6, 2026

Uh oh!

Copilot AI commented Jan 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Claude Skills 支持计划

背景

与 MCP 的关系

Phase 1: Skills 数据结构 (pulsar-agentic/skills)

Phase 2: 技能生成器 (SkillGenerator.kt)

Phase 3: 预置技能库 (built-in-skills/)

Phase 4: Skills 导出格式

Phase 5: Skills 管理

Phase 6: REST API 扩展 (pulsar-rest)

Phase 7: 测试与文档

预期输出示例

I tried to connect to the following addresses, but was blocked by firewall rules:

Uh oh!

galaxyeye commented Jan 6, 2026

Uh oh!

Copilot AI commented Jan 6, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Copilot AI commented Jan 5, 2026 •

edited

Loading

Copilot AI commented Jan 6, 2026 •

edited

Loading

Phase 1: Skills 数据结构 (`pulsar-agentic/skills`)

Phase 2: 技能生成器 (`SkillGenerator.kt`)

Phase 3: 预置技能库 (`built-in-skills/`)

Phase 6: REST API 扩展 (`pulsar-rest`)