使用说明
JustLog
一种旨在通过人工智能助手使用的卡路里、宏量和体重跟踪服务。没有用于数据输入的应用程序UI。你告诉你的人工智能你吃了什么，做了什么运动，或者你的体重，它就会处理剩下的事情。
核心思想：MCP服务器就是产品。Claude、ChatGPT或任何兼容MCP的客户端充当接口。人工智能从自然语言中估计卡路里和宏，JustLog存储这些数字。
运作原理
将JustLog MCP服务器连接到您的AI助手。然后正常地与它交谈：
- “我吃了一顿Publix三餐，配菜是面包卷、楔子和洋葱圈”
- “在跑步机上跑了30分钟，以2.5英里/小时的速度倾斜12%”
- “今天早上236点称重”
AI计算出营养分解、卡路里燃烧或体重条目，并通过MCP服务器记录下来。当你想查看你的数据时，只需询问——每日总计、每周平均值、趋势，无论你需要什么。
什么被跟踪
食物 --卡路里、蛋白质、碳水化合物、脂肪、纤维，以及你所吃食物的文字描述。
锻炼 --估计燃烧的卡路里和活动的文字描述。
重量 --体重（磅）。
就是这样。没有条形码扫描，没有食品数据库搜索，没有手动数据输入表格。人工智能进行估算工作，服务器存储数字。
堆栈
- 前端：Hugo+Bootstrap 5.3（通过Dart Sass实现SCSS）+TypeScript（esbuild）
- API：Pure Go HTTP服务器，部署到API网关后面的AWS Lambda
- MCP服务器：去吧，
mark3labs/mcp-go，可流式HTTP传输，部署到Lambda - 数据库：DynamoDB
- 认证：AWS Cognito（电子邮件/密码和谷歌登录）
- 托管：S3+CloudFront，基于KVS的蓝绿色部署
项目结构
site/ Hugo frontend (layouts, SCSS, TypeScript, content)
go/api/ Minimal HTTP handler library (context-based, no frameworks)
go/cmd/ CLI tools (esbuild compiler, hugo dev server, deploy)
go/lambda/api/ REST API (Lambda + API Gateway)
go/lambda/mcp/ MCP server (Lambda)
go/dynamo/ DynamoDB helpers
aws/ CloudFront Functions
看 AGENTS.md 获取完整的开发指南。
先决条件
- 转到1.22+
- 雨果（扩展版）
- Dart Sass
- Node.js+pnpm
- AWS CLI（已配置）
发展
# Install frontend dependencies
cd site && pnpm install && cd ..
# Start dev server (esbuild watch + Hugo server)
go run ./go/cmd/hugo-server
# Run API locally (port 8090)
go run ./go/lambda/api
# Run MCP server locally (port 8088)
go run ./go/lambda/mcp
部署
# Deploy Hugo site to S3 + CloudFront
go run ./go/cmd/deploy-site
# Deploy API Lambda
cd go/lambda/api && node deploy.js
# Deploy MCP Lambda
cd go/lambda/mcp && node deploy.js
认证
用户通过AWS Cognito使用电子邮件/密码或Google登录创建帐户。MCP服务器和API需要有效的承载令牌才能进行所有操作。每个用户的数据都是隔离的。
MCP服务器
服务器使用流式HTTP传输实现MCP 2025-06-18规范。它公开了记录食物、运动和体重的工具，以及查询历史数据的工具。看 AGENTS.md 有关AI代理应如何与服务器交互的详细指导。
许可证
麻省理工学院
