Alfred MCP服务器

Alfred MCP服务器通过模型上下文协议(MCP)将Alfred的工作流自动化平台与AI助手无缝集成,支持创建、管理和执行Alfred技能、管理连接、查看执行历史和处理API密钥。

  • by lumberjack-so
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 lumberjack-so/alfred-mcp

使用说明

Alfred MCP服务器

模型上下文协议服务器,将Alfred的REST API公开为MCP工具,用于与Claude和其他人工智能助手集成。

概述

Alfred MCP Server通过模型上下文协议在Alfred的工作流自动化平台和AI助手之间提供无缝集成。这使人工智能助手能够创建、管理和执行Alfred技能、管理连接、查看执行历史记录和处理API密钥。

主要特点

  • 20个MCP工具 覆盖所有Alfred API端点
  • 双重运输支持:HTTP(Smithery部署)和STDIO(本地Claude桌面)
  • 类型安全:使用TypeScript和Zod验证构建
  • 完整记录:全面的工具描述和输入模式
  • 生产就绪:错误处理、超时和正确的身份验证

可用工具

技能管理(6个工具)

  • alfred_list_skills -列出所有过滤、排序和分页技能
  • alfred_get_skill -获取特定技能的详细信息
  • alfred_create_skill -通过步骤和配置创建新技能
  • alfred_update_skill -更新整个技能(PUT语义)
  • alfred_patch_skill -部分更新技能(PATCH语义)
  • alfred_delete_skill -删除技能(带有可选的力量标志)

连接管理(6个工具)

  • alfred_list_connections -列出所有MCP服务器连接
  • alfred_get_connection -按ID获取连接详细信息
  • alfred_create_connection -创建新的MCP服务器连接
  • alfred_update_connection -更新整个连接配置
  • alfred_patch_connection -部分更新连接设置
  • alfred_delete_connection -删除连接

执行历史(5个工具)

  • alfred_list_executions -使用筛选器列出执行历史记录
  • alfred_get_execution -获取详细的执行信息
  • alfred_get_execution_trace -获取调试执行跟踪/日志
  • alfred_get_execution_stats -获取分析和统计数据
  • alfred_delete_execution -删除执行记录

API密钥管理(3个工具)

  • alfred_create_api_key -创建新的Alfred API密钥
  • alfred_list_api_keys -列出所有API密钥(不显示完整密钥)
  • alfred_delete_api_key -吊销API密钥

安装

选项1:STDIO模式(克劳德桌面)

添加到您的Claude Desktop配置中:

```json { “mcpServers”:{ “阿尔弗雷德”:{ “命令”:“npx”, “args”:[“-y”,“@alfred/mcp服务器”], “env”:{ “ALFRED_API_KEY”:“alf_xxxxxxxxxxxxxxxxxxxxxxx”, “ALFRED_BASE_URL”:“http://localhost:3001/api/v1" } } } } ```

选项2:HTTP模式(Smithery部署)

  1. 访问 Smithery.ai
  2. 搜索“Alfred MCP服务器”
  3. 使用API密钥和基本URL进行配置
  4. 一键部署

配置

必需

  • `apiKey`-您的Alfred API密钥(格式:`alf_xxx…`)

可选的

  • `baseUrl`-Alfred API基本URL(默认值:`http://localhost:3001/api/v1`)
  • `timeout `-请求超时(毫秒)(默认值:30000)

发展

建筑

```bash

安装依赖项

npm 安装

为STDIO模式构建

npm运行构建:stdio

HTTP部署构建(Smithery)

npm 运行构建 ```

项目结构

``` 阿尔弗雷德·麦克普/ ├── src/ │ ├── index.ts#双传输主服务器 │ ├── client.ts#Alfred API客户端包装器 │ ├── types.ts#TypeScript类型定义 │ └── 工具/ │ ├── skills.ts#技能管理工具 │ ├── connections.ts#连接管理工具 │ ├── executions.ts#执行历史记录工具 │ └── auth.ts#API密钥管理工具 ├── package.json 姓名: └── smithery.yaml#smithery平台配置 ```

许可证

麻省理工学院