Day Keeper MCP

日托中心主任mcp

一个MCP（模型上下文协议）服务器，将AI助手连接到 日间看护人 个人生活管理API。作为a建造 学习项目，展示MCP的全部功能——工具、资源和提示。

特性

工具（约30个动作）

资源（~12个只读数据源）

• 静态列表: daykeeper://spaces, daykeeper://calendars, daykeeper://projects,

daykeeper://categories, daykeeper://event-types

• 动态模板: daykeeper://space/{spaceId}, daykeeper://calendar/{calendarId},

daykeeper://event/{eventId}, daykeeper://task/{taskId}, daykeeper://person/{personId}, daykeeper://shopping-list/{listId}

• 架构引用: daykeeper://schema/entities

提示（6个交互模板）

技术栈

快速开始

先决条件

• 布置 安装
• 正在运行的Day Keeper API实例

安装

# Install Bun via mise
mise install

# Install dependencies
bun install

# Copy environment config
cp .env.example .env

配置

编辑 .env 使用您的Day Keeper API详细信息：

DAY_KEEPER_API_URL=http://localhost:8080
DAY_KEEPER_TENANT_ID=your-tenant-uuid

跑

# Start in stdio mode (default)
mise run dev

# Start in HTTP mode
mise run dev-http

# Open MCP Inspector for interactive testing
mise run inspect

配置

连接到客户

克劳德代码

添加 ~/.claude/mcp_servers.json:

{
  "day-keeper": {
    "command": "bun",
    "args": ["run", "/path/to/day-keeper-mcp/src/index.ts"],
    "env": {
      "DAY_KEEPER_API_URL": "http://localhost:8080",
      "DAY_KEEPER_TENANT_ID": "your-tenant-uuid"
    }
  }
}

克劳德桌面

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "day-keeper": {
      "command": "bun",
      "args": ["run", "/path/to/day-keeper-mcp/src/index.ts"],
      "env": {
        "DAY_KEEPER_API_URL": "http://localhost:8080",
        "DAY_KEEPER_TENANT_ID": "your-tenant-uuid"
      }
    }
  }
}

发展

# Run tests
mise run test

# Type-check
mise run typecheck

# Lint
mise run lint

# Lint with auto-fix
mise run lint-fix

# Interactive MCP Inspector
mise run inspect

看 docs/DEVELOPMENT.md 查看完整的开发人员指南。

建筑

看 docs/ARCHITECTURE.md 对于完整的架构文档， 包括：

• MCP服务器设计与传输策略
• DayKeeper API映射（GraphQL与REST）
• 实体分组和工具设计理念
• 错误处理和测试策略

美国存托凭证

许可证

麻省理工学院