AiPy Pro智能体开发指南

AiPy Pro智能体扩展基于Anthropic DXT（MCPB）项目构建，并在该基础上新增了适配 AiPy Pro 智能体集市的远程分发机制。借助这一机制，智能体可实现依赖打包，大幅提升配置的便捷性；同时，该扩展与 AiPy Pro 高度适配、协同联动，能够自动集成并落地应用 AI 大模型的能力。

智能体MCP服务

AiPy Pro智能体基于MCP服务构建，当在对话上下文中提供工具调用时，仅支持Streamable HTTP Server类型，并应满足如下要求：

manifest.json中的调整适配，需要在manifest.json keywords添加值conversation-tool
Server监听端口号不能固定，在启动时随机选择（因为需要给每个任务启动一个单独的实例）
在服务启动后，需要在STDOUT（标准输出）打印服务使用的端口号
支持启动时在当前任务系统提示词注入附加内容，需要提供一个名为addition-system-instruction的Prompt

运行环境

扩展在AiPy中会安装到以下目录中，测试时可以将代码复制对应目录；当您智能体开发完成并希望上架至官方智能体集市时，可以联系AiPy团队。

# Windows
C:\Users\用户名\AppData\Roaming\aipy-pro\extensions

# macOS
~/Library/Application Support/aipy-pro/extensions

# Linux
~/.config/aipy-pro/extensions

扩展安装目录结构

.../aipy-pro/extensions
└── @aipy-pro               # 组织名
    ├── stock               # 智能体
    │   ├── icon.svg        # 图标
    │   ├── manifest.json   # 入口元数据文件 
    │   └── server.js
    └── video               
        ├── icon.svg
        ├── manifest.json
        └── server.js

运行时环境变量

AiPy会将当前配置默认模型信息注入到运行环境中

名称	说明
MODEL_PROVIDER	固定为 trustoken
TRUSTOKEN_API	Trustoken API 地址，例如 https://api.trustoken.cn
TRUSTOKEN_BASE_URL	Trustoken 模型 API 地址，例如 https://api.trustoken.cn/v1
TRUSTOKEN_API_KEY	Trustoken API Key，例如 sk-xxx
TRUSTOKEN_MODEL	模型名，例如 auto

manifest.json

参考MCPB manifest.json 规范，部分MCPB新增的字段还不支持，构建时会有错误提示

{
    "dxt_version": "0.1",
    "name": "@aipy-pro/browser-use",
    "display_name": "BrowserUse",
    "version": "0.9.5",
    "description": "说明",
    "author": { "name": "作者" },
    "icon": "icon.svg",
    "server": {
        # 项目类型
        # - node: 使用Electron运行时fork启动
        # - 其他: 会创建子进程启动
        "type": "node",
        "entry_point": "server.js",  # 项目入口
        "mcp_config": {
            "command": "node",
            "args": ["${__dirname}/server.js"],
            "env": {}
        }
    },
    # 由于DXT不支持扩展字段，目前是在keywords下定义的特殊值来区分扩展类型
    #  - conversation-tool: 对话时使用的MCP工具
    #  - application：独立运行的程序
    "keywords": ["conversation-tool"]
}

项目构建

npx @anthropic-ai/dxt pack