AI导哈

arXiv研究助手

一个自动化的arXiv研究论文发现和AI驱动的摘要系统，集成了MCP（模型上下文协议）以用于Claude Desktop，旨在提供高效的研究洞察。

  • by jeffaf
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 jeffaf/kivv

使用说明

用于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.<username>.workers.dev/health

# Test MCP server
curl https://kivv-mcp.<username>.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 test on推送和拉取请求，以保持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

许可证

麻省理工学院

相关 MCP