A4E MCP服务器
这 A4E MCP服务器 使创建者能够直接在IDE（Cursor、Claude Desktop）中使用自然语言构建代理。
安装
先决条件
- Python 3.10+
- 紫外线 （推荐）或
pip - ngrok账户：“开发模式”需要与Hub共享您的本地代理。
- 注册地址： ngrok.com - 从仪表板获取您的Authtoken。
设置
- 导航到此目录：
cd a4e-mcp-server- 安装依赖项：
uv sync- 配置ngrok （一次性设置）：
ngrok config add-authtoken _或者稍后传递给 dev_start._
游标中的用法
选项1:MCP设置UI
- 首选 光标设置 > 特性 > 主控程序.
- 点击 +添加新的MCP服务器.
- 输入：
- 名字: 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)以交互方式显示该数据。
工作流程
- 创建代理:
在Cursor中打开一个新文件夹（例如。， my-agents/). 询问光标： _“创建营养教练代理”_ ->这将创建文件夹 nutrition-coach 和 agent.py, metadata.json等等。
- 添加工具:
问： _“添加计算BMI的工具”_ ->创建 tools/calculate_bmi.py.
- 添加视图:
问： _“添加视图以显示BMI结果”_ ->创建 views/bmi_result/view.tsx.
- 自动生成模式:
当你运行时，服务器会自动从你的Python代码和React props生成模式 generate_schemas （或者当文件监视器触发时（如果启用））。
代理是在哪里创建的？
代理是在您的 当前工作目录.
- 如果你想添加一个代理到
agent-store，请先在Cursor中打开该文件夹。 - 如果你正在测试，只需创建一个临时文件夹。
整合
- 本地开发人员:
dev_start-启动本地服务器和ngrok隧道。 - 部署:
deploy（模拟）-将上传到S3并在Hub注册。
故障排除
“未安装pyngrok”
如果 dev_start 如果失败，则意味着MCP服务器环境缺少依赖关系。
- 跑
check_environment诊断工具。 - 确保你跑了
uv sync在a4e-mcp-server目录。 - 重新启动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代理开发的各个方面
- 符合标准：追随开放 代理技能 格式