Asynq MCP服务器
这是官方的模型上下文协议（MCP）服务器 异步任务. 它充当MCP客户端（如Claude Desktop）和Asynq平台之间的桥梁/代理。
特性
- 决策搜索：从团队历史中查找相关决策。
- 上下文检索：“软”与“硬”内存访问。
- 草稿创建：直接从聊天中创建新决策。
- 评论并最终确定：在不离开人工智能助手的情况下参与决策。
______________________________________________________________________
代理商指南
为了确保最佳体验，AI代理（Claude）在与Asynq交互时应遵循这些准则。这些也可以通过 asynq://guidelines 资源。
1.决策链接
- 总是 提供指向您引用、创建或修改的任何决策的直接链接。
- 格式:
https://asynq.org/d/{decision_id}
2.最后决定
- 重访至关重要：当用户要求最终确定决定时， 始终检查他们是否想安排回访.
- 明确提问：如果用户没有提及重访日期，请询问： _“您是否希望为此决定安排一次重新访问（例如，在3个月内），以验证它仍然有效？”_
3.创建草稿
- 捕获上下文：在创建草稿时，请在
context_markdown现场。 - 别偷懒：不要只说“如前所述”。包括优缺点、限制和聊天中提出的关键论点。
- 变体：如果讨论了具体选项，请立即将其创建为变体。
4.色调和风格
- 目标：Asynq是一个记录系统。专业、简洁、客观。
- 无绒毛：避免“这是决定……”序言日期上下文。只需陈述上下文。
______________________________________________________________________
建筑
此服务器设计为 轻量级代理. 它在本地处理JSON-RPC通信，并将经过身份验证的请求转发给Asynq API(https://asynq.org/mcp). 这确保了：
- 安全：您的PAT（个人访问令牌）得到了安全处理。
- 更新：添加到Asynq平台的新工具可以立即使用，而无需更新此本地服务器。
______________________________________________________________________
例子
示例1：使用选项创建决策
用户提示： “我需要决定我们的新项目是使用PostgreSQL还是MongoDB。为此做出决定。”
预期行为：
- Asynq创建了一份题为“数据库选择：PostgreSQL vs MongoDB”的新决定草案
- 为每个选项创建两个变体
- 返回带有决策链接的确认
示例2：搜索并回顾过去的决策
用户提示： “我们对定价策略做出了什么决定？”
预期行为：
- Asynq搜索“定价”决策
- 返回匹配的决策及其状态（草稿/最终）
- 显示为最终决策选择了哪个选项
示例3：为正在进行的讨论添加上下文
用户提示： “在数据库决策中添加一条注释，说明MongoDB对我们的用例具有更好的横向扩展性”
预期行为：
- Asynq找到相关决定
- 将评论添加到决策的讨论线程中
- 确认该评论是以作者身份发布的
示例4：最终确定决策
用户提示： “我们决定使用PostgreSQL。在最终确定数据库决定时，请注意我们选择它是因为它符合ACID标准。”
预期行为：
- Asynq将PostgreSQL变体标记为所选选项
- 添加关于ACID合规性的最后说明
- 决策状态从草稿变为最终
- 返回带有最终决定细节的确认
示例5：安排决策回访
用户提示： “设置提醒，在6个月内重新审视我们的数据库决定”
预期行为：
- Asynq计划在6个月后再次访问
- 返回带有预定日期的确认信息
- 日期到达时，用户将收到提醒
______________________________________________________________________
发展
先决条件
- 包子 （v1.0.0或更高版本）
- Asynq账户
设置
- 克隆此存储库。
- 安装依赖项：
bun install- 构建项目：
bun run build本地测试
您可以直接运行服务器：
export ASYNQ_PAT="your-pat-here"
bun run start______________________________________________________________________
捆绑配送（.mcpb）
这 .mcpb 该文件是一个标准的ZIP存档，包含扩展代码和清单。 它被视为二进制发布工件，不应提交到存储库。
本地生成
要在本地生成它以进行测试，请执行以下操作：
bun run bundle这将运行 mcpb pack . asynq.mcpb，在根目录中创建捆绑包。 您可以拖放 asynq.mcpb 进入Claude Desktop安装扩展程序。
______________________________________________________________________
发布工作流程（CI/CD）
我们使用GitHub Actions来自动化发布过程。当新标签（例如。， v1.0.1)被按下：
- 工作流构建项目(
bun run build). - 使用
mcpb打包扩展(bun run bundle). - 它创建了一个GitHub版本并附加了
.mcpb文件作为可下载资产。
然后，用户可以从以下网址下载最新版本 发布页面.
______________________________________________________________________
隐私政策
此扩展与Asynq平台通信，以在Claude Desktop（或其他兼容的MCP客户端）中提供决策能力。它向Asynq API发送以下信息：
- 决策标题、描述和评论
- 用户身份验证凭据（个人访问令牌）
- 搜索查询和筛选参数
备注：扩展不会向Asynq API发送任何对话内容或用户消息。它只发送创建和管理决策所需的结构化数据。
所有数据均按照 Asynq隐私政策.
______________________________________________________________________
许可证
麻省理工学院