MCP Tempo

节奏mcp

MCP（模型上下文协议）服务器 Tempo时间表 和 Tempo容量规划器 （Atlassian Cloud）。

允许Claude Desktop以自然语言与Tempo交互：

*“今天在YEL-241上输入2小时，账户510119”* *“向我展示我团队本周的工作日志”* *“在6月为Alice创建一个5天的Infra计划”*

______________________________________________________________________

建筑

Claude Desktop
    │  stdio
    ▼
mcp-remote (npx)                ← gère OAuth + stockage local des tokens (~/.mcp-auth/)
    │  Streamable HTTP + Bearer token
    ▼
tempo-mcp  (src/server.ts)      ← ce projet — stateless, aucun stockage de tokens
    │  Bearer token
    ▼
api.tempo.io/4

• 无状态 ：服务器不存储任何令牌。MCP远程管理客户端OAuth生命周期
• 受保护的秘密 : TEMPO_CLIENT_SECRET 永远不要离开服务器
• 多用户 ：每个MCP会话在内存中隔离（映射） sessionId → token)
• 安全 ：速率限制、头盔、cookie HttpOnly、重定向URI验证

______________________________________________________________________

项目结构

mcp-tempo/
├── src/
│   ├── server.ts             ← Serveur Express (OAuth proxy + MCP endpoint)
│   ├── config.ts             ← Validation et accès aux variables d'environnement
│   ├── context.ts            ← AsyncLocalStorage — token par session MCP
│   ├── tempo-client.ts       ← Client HTTP Tempo API v4
│   └── tools/
│       ├── timesheets.ts     ← Outils Timesheets (worklogs, approbations, comptes)
│       └── capacity-planner.ts ← Outils Capacity Planner (plans, équipes)
├── dist/                     ← Compilé TypeScript (npm run build)
├── Dockerfile                ← Build multi-stage pour Railway / Docker
├── .env.example              ← Modèle de configuration
├── INSTALLATION.md           ← Guide d'installation entreprise
├── package.json
└── tsconfig.json

______________________________________________________________________

先决条件

______________________________________________________________________

本地安装（开发）

git clone  mcp-tempo
cd mcp-tempo
npm install
cp .env.example .env
# Éditer .env avec vos valeurs
npm run build
npm start

______________________________________________________________________

环境变量

如果缺少强制变量，服务器拒绝启动，或者 PUBLIC_URL 不是有效的URL。 无令牌存储变量-服务器完全无状态。

______________________________________________________________________

铁路部署

# 1. Pusher le code sur GitHub
# 2. Créer un projet Railway → Deploy from GitHub
# 3. Railway détecte le Dockerfile automatiquement
# 4. Renseigner les variables dans Railway → Variables
# 5. Récupérer l'URL publique Railway et mettre à jour PUBLIC_URL et OAUTH_REDIRECT_URI

无需卷-服务器不保留任何数据。

______________________________________________________________________

端点HTTP

______________________________________________________________________

配置克劳德桌面

File → 设置→ 开发者→ 编辑配置 :

{
  "mcpServers": {
    "tempo": {
      "command": "npx",
      "args": ["mcp-remote", "https://votre-app.up.railway.app/mcp"]
    }
  }
}

将URL替换为铁路服务器的URL（或 http://localhost:3000/mcp 本地）。

第一次连接 ：Claude Desktop自动打开Tempo授权页面的浏览器。验证后，建立连接，并由MCP Remote自动管理令牌刷新。

______________________________________________________________________

MCP工具可用

工时表

容量规划师

______________________________________________________________________

注释API Tempo v4

• 问题ID与clé Tempo v4 API 需要issueId 整数，而不是文本键（PROJ-123).

要转换： GET {JIRA_URL}/rest/api/3/issue/PROJ-123?fields=id

• 分页 ：所有列表端点都支持 limit （最多5000）et offset
• 计划 ：由用户管理（accountId）-团队计划在v4中不可用
• 工作日志属性 ：使用 get_work_attributes 要了解实例的确切密钥：

______________________________________________________________________

命令

npm run build   # Compiler TypeScript → dist/
npm start       # Démarrer le serveur
npm run dev     # Compilation watch

______________________________________________________________________

安全

______________________________________________________________________

故障排除