原田MCP服务器
模型上下文协议服务器,包装Harada方法API,以便Claude Desktop(或任何符合MCP的客户端)可以使用工具操作目标、子目标、动作日志和留言簿条目。
快速开始
git clone https://github.com/Jacob-Stokes/xharada-mcp.git
cd xharada-mcp
npm install
npm run build服务器期望:
HARADA_API_URL(默认为https://harada.jacobstokes.com)HARADA_API_KEY--在原田设置中创建一个→ API密钥选项卡。
您还可以覆盖 apiKey/apiUrl 每次工具调用。
可用工具
| 工具 | 目的 |
|---|---|
get_harada_overview | 从这里开始。 获取完整的登录页:目标、子目标、行动、指导和API信息 |
get_summary | 获取具有可选详细级别、日志和留言簿标志的用户摘要树 |
list_goals | 列出所有主要目标 |
upsert_goal | 创建或更新主要目标(提供 goalId 更新) |
upsert_subgoal | 创建或更新子目标(提供 subGoalId 更新) |
upsert_action | 创建或更新操作(提供 actionId 为了更新, completed 切换) |
upsert_action_log | 创建或更新活动日志条目(提供 logId 更新) |
bulk_import_goals | 在一次操作中导入完整的目标树(目标+子目标+动作+日志) |
post_guestbook_entry | 留下用户/目标/子目标/行动鼓励笔记 |
reorder_subgoal | 将子目标移动到新的位置(0-7) |
reorder_action | 在8格(0-7)内移动一个动作 |
delete_resource | 按类型和ID删除任何资源(目标、子目标、行动、日志、留言簿) |
全部 upsert_* 工具遵循相同的模式:省略要创建的ID,提供它来更新。
这 bulk_import_goals 该工具比增量创建目标要高效得多。当你想创建整个原田网格时使用它(1个目标→ 8 次级目标→ 64 动作)。
Claude桌面配置
将此添加到您的Claude Desktop配置文件中(位置因操作系统而异):
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"harada": {
"command": "node",
"args": ["/FULL/PATH/TO/xharada-mcp/dist/server.js"],
"env": {
"HARADA_API_KEY": "YOUR_KEY_HERE",
"HARADA_API_URL": "https://harada.jacobstokes.com"
}
}
}
}替换 /FULL/PATH/TO/xharada-mcp/ 使用克隆存储库的实际路径。
接通后,拨打 get_harada_overview 首先了解目标结构,然后使用 upsert_* 直接从对话中创建或修改目标、子目标和行动的工具。
