AI导哈

A4E MCP 服务器

A4E MCP Server 是一个允许开发者在 IDE（如 Cursor、Claude Desktop）中通过自然语言构建 AI 代理的工具。

  • by simetrik-inc-public
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 simetrik-inc-public/a4e-mcp-server

使用说明

A4E MCP服务器

这 A4E MCP服务器 使创建者能够直接在IDE（Cursor、Claude Desktop）中使用自然语言构建代理。

安装

先决条件

  1. Python 3.10+
  2. 紫外线 （推荐）或 pip
  3. ngrok账户：“开发模式”需要与Hub共享您的本地代理。
    • 注册地址： ngrok.com
    • 从仪表板获取您的Authtoken。

设置

  1. 导航到此目录：
    cd a4e-mcp-server
  2. 安装依赖项：
    uv sync
  3. 配置ngrok （一次性设置）：
    ngrok config add-authtoken <YOUR_TOKEN>
    或者稍后传递给 dev_start.

游标中的用法

选项1:MCP设置UI

  1. 首选 光标设置 > 特性 > 主控程序.
  2. 点击 +添加新的MCP服务器.
  3. 输入：
    • 名字: a4e
    • 类型: command
    • 命令: uv
    • 参数: run --directory /path/to/a4e-mcp-server python -m a4e.server

选项2:mcp.json配置（推荐）

编辑 ~/.cursor/mcp.json （或 .cursor/mcp.json 在您的项目中）：

{
  "mcpServers": {
    "a4e": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/a4e-mcp-server",
        "python",
        "-m",
        "a4e.server",
        "--project-dir",
        "/absolute/path/to/a4e-mcp-server"
      ]
    }
  }
}

macOS示例：

{
  "mcpServers": {
    "a4e": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/Users/yourname/Documents/a4e-mcp-server",
        "python",
        "-m",
        "a4e.server",
        "--project-dir",
        "/Users/yourname/Documents/a4e-mcp-server"
      ]
    }
  }
}

配置选项

选项 描述
--directory a4e mcp服务器存储库的路径
--project-dir 创建代理的位置（默认为当前目录）

添加后，重新启动Cursor以加载MCP服务器。你应该看看 21工具 可用。

在Claude Desktop中的使用

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "a4e": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/a4e-mcp-server",
        "python",
        "-m",
        "a4e.server"
      ]
    }
  }
}

概念

什么是A4E代理？

一 A4E代理 是为特定领域或任务量身定制的专业人工智能助手（例如营养教练或每日计划员）。它将自然语言理解与以下定义的自定义功能相结合 工具 和 视图.

工具

工具 是Python函数，使代理能够执行操作或检索信息。

  • 定义于 tools/*.py 使用 @tool 装饰师。
  • 代理根据用户的请求决定何时调用工具。
  • 运作原理：当你问“计算BMI”时，代理会寻找一个能够进行该计算的工具，执行Python代码，并返回结果。

视图

视图 是React组件，为代理的响应提供了丰富的图形界面。

  • 定义于 views/*/view.tsx.
  • 用于显示结构化数据（如图表、列表或表单），而不仅仅是文本。
  • 运作原理：如果工具返回复杂数据（如膳食计划），代理可以选择呈现特定视图（例如。， MealPlanView)以交互方式显示该数据。

工作流程

  1. 创建代理: 在Cursor中打开一个新文件夹（例如。， my-agents/). 询问光标： “创建营养教练代理” ->这将创建文件夹 nutrition-coach 和 agent.py, metadata.json等等。

  2. 添加工具: 问： “添加计算BMI的工具” ->创建 tools/calculate_bmi.py.

  3. 添加视图: 问： “添加视图以显示BMI结果” ->创建 views/bmi_result/view.tsx.

  4. 自动生成模式: 当你运行时，服务器会自动从你的Python代码和React props生成模式 generate_schemas （或者当文件监视器触发时（如果启用））。

代理是在哪里创建的？

代理是在您的 当前工作目录.

  • 如果你想添加一个代理到 agent-store，请先在Cursor中打开该文件夹。
  • 如果你正在测试，只需创建一个临时文件夹。

整合

  • 本地开发人员: dev_start -启动本地服务器和ngrok隧道。
  • 部署: deploy （模拟）-将上传到S3并在Hub注册。

故障排除

“未安装pyngrok”

如果 dev_start 如果失败，则意味着MCP服务器环境缺少依赖关系。

  1. 跑 check_environment 诊断工具。
  2. 确保你跑了 uv sync 在 a4e-mcp-server 目录。
  3. 重新启动IDE/MCP客户端以重新加载环境。

“找不到ngrok命令”

如果你不想使用 pyngrok，手动安装ngrok CLI：

  • 雨衣： brew install ngrok/ngrok/ngrok
  • 窗户： choco install ngrok

代理技能

此存储库包括 代理技能 兼容技能，教AI助手如何使用自然语言构建A4E代理。

包含什么

这 A4E代理生成器 技能提供以下方面的全面知识：

  • 代理架构和目录结构
  • MCP服务器工具及其使用
  • 数据库集成模式（SQLite、Supabase、PostgreSQL、MySQL、MongoDB）
  • 移动优化视图开发
  • UI/UX设计体系和指南
  • 部署工作流程和最佳实践

安装

地点： skills/a4e-agent-builder/

该技能适用于多种AI开发工具，包括：

  • 克劳德代码
  • 光标
  • 克劳德桌面
  • VS代码并继续
  • 帆板运动
  • 克莱恩
  • 帮助
  • 任何与Agent Skills兼容的工具

Claude代码的快速安装：

# Copy to personal skills directory
cp -r skills/a4e-agent-builder ~/.claude/skills/

# Or create a symlink for auto-updates
ln -s "$(pwd)/skills/a4e-agent-builder" ~/.claude/skills/

对于其他平台和详细说明： 看 技能安装.md

用法

安装后，该技能将自动可用：

  • 自动激活：询问有关构建A4E代理的问题
  • 直接调用：使用 /a4e-agent-builder 在支持的工具中
  • 参考访问：该技能可按需访问详细指南

好处

  • 便携式知识：适用于20多种AI开发工具
  • 始终保持最新状态：基于Git的安装使更新变得容易
  • 全面的：涵盖A4E代理开发的各个方面
  • 符合标准：追随开放 代理技能 格式

相关 MCP