用于Claude Desktop的自动化arXiv研究论文发现和人工智能摘要系统，集成了MCP（模型上下文协议）。作为一个氛围编码项目，我们保持了工具的轻量级和快速的反馈循环，这样你就可以在发布研究见解的同时保持流畅。
特性
- 日常自动化：自动搜索arXiv以查找与您的主题匹配的论文
- AI摘要：基于克劳德的智能论文摘要，具有成本优化功能
- 多用户：支持具有独立主题配置的多个用户
- MCP集成：通过模型上下文协议与Claude Desktop直接集成
- 订阅：任何提要阅读器的每个用户RSS/Atom提要
- Web仪表板：可选的SvelteKit仪表板（即将推出）
- 成本有效：主要在Cloudflare免费层上运行（2名用户每月约3美元）
建筑
- MCP服务器：TypeScript Worker处理MCP协议和工具执行
- 日常自动化：Cron触发Worker进行论文收集和汇总
- 存储：Cloudflare D1（SQLite）、R2（PDF）、KV（缓存）
- 人工智能：Claude 3.5 Sonnet与Haiku分流以优化成本
快速开始
先决条件
- 启用Workers、D1、KV和R2的Cloudflare帐户
- 人类克劳德API密钥(console.anthropic.com)
- Bun 1.1+ （软件包管理器-从安装 bun.sh)
- Wrangler CLI（通过bun自动安装）
安装
# Clone the repository
git clone https://github.com/jeffaf/kivv.git
cd kivv
# Install dependencies with bun (our vibe-coding default)
bun install
# Set up environment variables
cp .env.example .env
# Edit .env with your API keys and Cloudflare credentials部署
有关完整的部署说明，请参阅 部署.md.
快速部署：
# Set secrets for automation worker
cd automation
wrangler secret put CLAUDE_API_KEY
wrangler secret put CRON_SECRET
# Deploy automation worker
wrangler deploy
# Deploy MCP server
cd ../mcp-server
wrangler deploy
# Configure Claude Desktop (see DEPLOYMENT.md for details)
# Add MCP server URL and API key to Claude Desktop config验证
# Test automation worker
curl https://kivv-automation..workers.dev/health
# Test MCP server
curl https://kivv-mcp..workers.dev/health
# Check database
wrangler d1 execute kivv-db --command "SELECT COUNT(*) FROM users"
# Or use the automated health check script
./scripts/health-check.sh看 故障排除.md 如果你遇到任何问题。
自动部署脚本
对于一个命令部署：
# Run the automated deployment script
./scripts/deploy.sh
# This will:
# - Verify prerequisites
# - Check infrastructure
# - Configure secrets
# - Deploy both workers
# - Provide Claude Desktop config项目结构
kivv/
├── mcp-server/ # MCP Server Worker (Claude integration)
├── automation/ # Daily automation Worker (cron)
├── shared/ # Shared types and utilities
├── tests/
│ ├── security/ # Security tests (auth, injection, XSS)
│ ├── integration/ # MCP tool integration tests
│ └── unit/ # Unit tests
├── .checkpoint/ # Development checkpoints
└── package.json # Monorepo root with workspaces文档
CI与自动化
- 测试和类型检查：GitHub操作运行
bun run type-check和bun teston推送和拉取请求，以保持vibe编码快速，而不会破坏构建。 - 部署：Cloudflare Workers部署管道在以下情况下触发
mcp-server/或automation/改变，使用wrangler使用您配置的Cloudflare凭据。
发展
# Run type checking
bun run type-check
# Run all tests
bun test
# Run security tests specifically
bun run test:security
# Run tests in watch mode
bun run test:watch
# Run MCP server locally
bun run dev:mcp
# Run automation worker locally
bun run dev:automation
# Build all workspaces
bun run build测试
该项目包括全面的测试覆盖范围：
- 安全测试 （需要100%的覆盖率）：
- 身份验证（API密钥验证） - 授权（用户数据隔离） - SQL注入预防 - RSS源中的XSS预防 - 限速执行
- 集成测试：端到端MCP工具工作流程
- 单元测试：隔离实用功能测试
# Run with coverage report
bun run test:coverage许可证
麻省理工学院