Intend MCP

Intend.do MCP服务器

A. 模型上下文协议（MCP） 服务器，为AI助手提供访问您的Intend.do帐户的权限，使他们能够帮助您管理意图、跟踪结果和控制计时器。

什么是MCP服务器？

MCP服务器是一个中介，允许AI助手（如Cursor中的Claude）通过标准化协议与外部服务进行交互。此服务器公开：

• 工具：添加意图、完成任务、启动计时器等操作
• 资源：今天的意图、目标、计时器状态等数据
• 提示词：（即将推出）用于常见查询的预定义模板

为什么要建造这个？

由于您经常使用Intend.do，因此拥有MCP服务器意味着您可以：

• 问你的人工智能助理：“在我的意图中添加‘审查项目提案’”
• 获取更新：“我的下一步行动是什么？”
• 跟踪工作：“将我当前的任务标记为已完成”
• 控制定时器：“启动一个25分钟的番茄钟”

无需离开您的AI聊天界面！

设置

1.安装依赖项

npm install

2.获取您的身份验证令牌

您需要：

• 个人身份验证令牌 （用于测试/个人使用）：登录 intend.do/pacilient/docs 并复制您的令牌
• OAuth2访问令牌 （适用于申请）：请遵循 OAuth2说明 创建OAuth2应用程序

3.配置身份验证

创建一个 .env 项目根目录中的文件：

cp .env.example .env

然后编辑 .env 并添加您的令牌：

# For personal auth token:
INTEND_AUTH_TOKEN=your_auth_token_here

# OR for OAuth2:
INTEND_ACCESS_TOKEN=your_access_token_here

注： 这 .env 文件已在 .gitignore，因此您的令牌不会被提交。环境变量（通过设置 export)如果你喜欢这种方法，它也会奏效。

4.构建和运行

npm run build
npm start

或用于开发：

npm run dev

Cursor/Claude桌面配置

将此添加到MCP设置中（通常在 ~/.config/cursor/mcp.json 或类似）：

选项1：使用.env文件 （推荐-将令牌排除在配置之外）

如果你已经设置 .env 在项目目录中，服务器将自动加载它：

{
  "mcpServers": {
    "intend": {
      "command": "node",
      "args": ["/path/to/intend-mcp/dist/index.js"],
      "cwd": "/path/to/intend-mcp"
    }
  }
}

选项2:config中的环境变量

您还可以直接在MCP配置中设置令牌：

{
  "mcpServers": {
    "intend": {
      "command": "node",
      "args": ["/path/to/intend-mcp/dist/index.js"],
      "env": {
        "INTEND_AUTH_TOKEN": "your_auth_token_here"
      }
    }
  }
}

或者对于OAuth2访问令牌：

{
  "mcpServers": {
    "intend": {
      "command": "node",
      "args": ["/path/to/intend-mcp/dist/index.js"],
      "env": {
        "INTEND_ACCESS_TOKEN": "your_access_token_here"
      }
    }
  }
}

可用工具

• get_next_action -弄清楚你接下来应该做什么
• get_today_data -获取今天的完整页面数据
• get_goals -列出活动目标（任务分配给目标，数字标识目标分配）
• add_intention -添加新意图
• complete_intention -将意图标记为完成
• post_outcome -发布你实际做了什么
• mark_not_today -将意图标记为“不是今天”
• move_to_current -将意图移至列表顶部
• get_timer_status -获取当前计时器状态
• start_pomodoro -启动番茄定时器
• start_break -启动中断计时器

可用资源

• intend://today/core -核心今日数据
• intend://today/full -今日完整页面
• intend://goals -主动目标（数字表示任务分配给哪些目标）
• intend://userinfo -用户信息

示例用法

配置后，您可以向AI助手询问以下问题：

• “我在Intend的下一步行动是什么？”
• “将‘写博客文章’添加到我的意图中”
• “将当前任务标记为已完成”
• “我的积极目标是什么？”
• “开始一个25分钟的番茄钟”

发展

# Watch mode for development
npm run watch

# Run in development mode
npm run dev

API 参考

此服务器包装 API意向书。有关基础端点的详细信息，请参阅该文档。

安全说明

确保您的身份验证令牌安全！永远不要将它们提交给版本控制。考虑使用机密管理器或环境变量管理工具。

许可证

麻省理工学院