easy-backlog-tools 1.0.0

package/README.md

@@ -0,0 +1,59 @@
+# easy-backlog-mcp
+
+Claude Desktop から [easy-log](https://github.com/coco-tomoya/easy-log) の課題を操作できる MCP サーバー。
+
+## セットアップ
+
+### 1. Claude Desktop の設定を開く
+
+`~/Library/Application Support/Claude/claude_desktop_config.json` を編集：
+
+```json
+{
+  "mcpServers": {
+    "easy-log": {
+      "command": "npx",
+      "args": ["-y", "easy-backlog-mcp"],
+      "env": {
+        "DATABASE_URL": "postgresql://postgres.<project-id>:<password>@aws-1-ap-northeast-1.pooler.supabase.com:6543/postgres"
+      }
+    }
+  }
+}
+```
+
+`DATABASE_URL` は Supabase プロジェクトの Transaction Pooler URL を設定する。
+
+### 2. Claude Desktop を再起動
+
+設定を反映するために Claude Desktop を再起動する。
+
+---
+
+## 使えるツール
+
+| ツール名 | 説明 |
+|---|---|
+| `list_issues` | アクティブな課題を一覧表示 |
+| `add_issue` | 課題を1件追加 |
+| `add_issues_bulk` | 複数課題を一括追加 |
+| `list_users` | メンバー一覧を表示 |
+
+---
+
+## 使い方の例
+
+```
+以下の課題を登録してください：
+- ログイン画面の実装
+- 認証APIの実装
+- テストコードの作成
+```
+
+```
+アクティブな課題を見せて
+```
+
+```
+山田さん担当の課題だけ見せて
+```

package/cli.js

@@ -0,0 +1,164 @@
+#!/usr/bin/env node
+/**
+ * easy-backlog CLI（AI agent向け設計）
+ */
+
+const { listIssues, addBulk, updateBulk, deleteBulk, exec, listUsers } = require("./lib/db");
+
+const args = process.argv.slice(2);
+const cmd = args[0];
+
+// ── フラグパース ───────────────────────────────────────
+function parseFlags(args) {
+  const opts = { _: [] };
+  for (let i = 0; i < args.length; i++) {
+    if (args[i].startsWith("--")) {
+      const key = args[i].slice(2);
+      opts[key] = args[i + 1] !== undefined && !args[i + 1].startsWith("--") ? args[i + 1] : true;
+      if (opts[key] !== true) i++;
+    } else {
+      opts._.push(args[i]);
+    }
+  }
+  return opts;
+}
+
+// ── JSON or フラグ → 配列に正規化 ─────────────────────
+function toArray(arg, fallbackOpts) {
+  if (!arg) return [fallbackOpts];
+  try {
+    const parsed = JSON.parse(arg);
+    return Array.isArray(parsed) ? parsed : [parsed];
+  } catch {
+    return [fallbackOpts];
+  }
+}
+
+// ── 出力 ──────────────────────────────────────────────
+function output(data, json) {
+  if (json) {
+    console.log(JSON.stringify(data, null, 2));
+  } else if (typeof data === "string") {
+    console.log(data);
+  } else if (Array.isArray(data)) {
+    data.forEach(r => console.log(r.ok === false ? `✗ ${r.key ?? r.title}: ${r.error}` : `✓ ${r.key} ${r.title ?? ""}`));
+  } else {
+    console.log(JSON.stringify(data, null, 2));
+  }
+}
+
+function formatIssue(i) {
+  const indent = i.parent_key ? "  └─ " : "";
+  const cat = i.category ? ` [${i.category}]` : "";
+  const who = i.assignee_name ? ` @${i.assignee_name}` : "";
+  const due = i.due_date ? ` 期限:${i.due_date}` : "";
+  return `${indent}${i.key} ${i.status} ${i.priority} | ${i.title}${cat}${who}${due}`;
+}
+
+async function main() {
+  const opts = parseFlags(args.slice(1));
+  const isJson = !!opts.json;
+
+  switch (cmd) {
+
+    // ── list ────────────────────────────────────────
+    case "list": {
+      const issues = await listIssues({
+        all: !!opts.all,
+        status: opts.status,
+        assignee: opts.assignee,
+        category: opts.category,
+        priority: opts.priority,
+        parentKey: opts.parent,
+      });
+      if (!issues.length) { console.log("該当する課題はありません"); break; }
+      if (isJson) { console.log(JSON.stringify(issues, null, 2)); break; }
+      issues.forEach(i => console.log(formatIssue(i)));
+      break;
+    }
+
+    // ── add（single/bulk）────────────────────────────
+    case "add": {
+      const jsonArg = opts._.length ? opts._[0] : null;
+      const items = toArray(jsonArg, {
+        title: opts.title, priority: opts.priority, status: opts.status,
+        assignee: opts.assignee, parent: opts.parent, category: opts.category,
+        color: opts.color, description: opts.description,
+      });
+      const results = await addBulk(items);
+      output(results, isJson);
+      break;
+    }
+
+    // ── update（single/bulk）─────────────────────────
+    case "update": {
+      const jsonArg = opts._.length ? opts._[0] : null;
+      const items = toArray(jsonArg, {
+        key: opts._[0], title: opts.title, priority: opts.priority,
+        status: opts.status, assignee: opts.assignee, category: opts.category,
+        color: opts.color, description: opts.description,
+      });
+      const results = await updateBulk(items);
+      output(results, isJson);
+      break;
+    }
+
+    // ── delete（single/bulk）─────────────────────────
+    case "delete": {
+      const jsonArg = opts._.length ? opts._[0] : null;
+      let keys;
+      try {
+        const parsed = JSON.parse(jsonArg);
+        keys = Array.isArray(parsed) ? parsed : [parsed];
+      } catch {
+        keys = opts._.length ? opts._ : [];
+      }
+      if (!keys.length) { console.error("エラー: キーを指定してください"); process.exit(1); }
+      const results = await deleteBulk(keys);
+      output(results, isJson);
+      break;
+    }
+
+    // ── exec（batch: add + update + delete 混在）──────
+    case "exec": {
+      const jsonArg = opts._.length ? opts._[0] : null;
+      if (!jsonArg) { console.error('エラー: JSON を指定してください\n例: exec \'{"add":[...],"update":[...],"delete":["EASY-3"]}\''); process.exit(1); }
+      const payload = JSON.parse(jsonArg);
+      const results = await exec(payload);
+      output(results, isJson);
+      break;
+    }
+
+    // ── users ────────────────────────────────────────
+    case "users": {
+      const users = await listUsers();
+      if (isJson) { console.log(JSON.stringify(users, null, 2)); break; }
+      users.forEach(u => console.log(`${u.name} (id:${u.id})`));
+      break;
+    }
+
+    // ── ヘルプ ───────────────────────────────────────
+    default:
+      console.log(`
+easy-backlog-tools CLI
+
+使い方:
+  list   [--all] [--status <状態>] [--assignee <名前>] [--category <カテゴリ>] [--priority <優先度>] [--parent <キー>] [--json]
+  add    --title <タイトル> [--priority 高] [--category バックエンド] ...
+  add    '[{"title":"..."},{"title":"..."}]'
+  update <key> --status 完了
+  update '[{"key":"EASY-3","status":"完了"},{"key":"EASY-4","priority":"緊急"}]'
+  delete EASY-3
+  delete '["EASY-3","EASY-4"]'
+  exec   '{"add":[...],"update":[...],"delete":["EASY-3"]}'
+  users  [--json]
+      `);
+  }
+
+  process.exit(0);
+}
+
+main().catch(e => {
+  console.error(`エラー: ${e.message}`);
+  process.exit(1);
+});

package/index.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+/**
+ * easy-backlog-tools エントリーポイント
+ *
+ * --mcp       → MCPサーバーモード
+ * 引数あり    → CLIモード
+ * 引数なし    → 環境チェック
+ */
+
+const args = process.argv.slice(2);
+
+if (args.includes("--mcp")) {
+  require("./server");
+} else if (args.length > 0) {
+  require("./cli");
+} else {
+  // 環境チェック
+  const ok = "✓";
+  const ng = "✗";
+
+  const dbUrl = process.env.DATABASE_URL;
+  console.log(`\neasy-backlog-tools\n`);
+  console.log(`${dbUrl ? ok : ng} DATABASE_URL: ${dbUrl ? "設定済み" : "未設定"}`);
+
+  if (!dbUrl) {
+    console.log(`\n設定方法:\n  export DATABASE_URL="postgresql://..."\n`);
+    process.exit(1);
+  }
+
+  // DB接続確認
+  const { sql } = require("./lib/db");
+  sql`SELECT 1`.then(() => {
+    console.log(`${ok} DB接続: 成功\n`);
+    console.log(`使い方: easy-backlog-tools --help`);
+    process.exit(0);
+  }).catch(e => {
+    console.log(`${ng} DB接続: 失敗 (${e.message})\n`);
+    process.exit(1);
+  });
+}

package/lib/db.js

@@ -0,0 +1,183 @@
+/**
+ * easy-backlog DB操作 共通ロジック
+ */
+
+const postgres = require("postgres");
+
+const sql = postgres(process.env.DATABASE_URL, {
+  ssl: "require",
+  max: 1,
+  prepare: false,
+  idle_timeout: 60,
+});
+
+async function nextKey() {
+  const rows = await sql`SELECT key FROM issues ORDER BY id DESC LIMIT 1`;
+  if (!rows.length) return "EASY-1";
+  const num = parseInt(rows[0].key.split("-")[1], 10);
+  return `EASY-${num + 1}`;
+}
+
+async function resolveAssignee(assignee) {
+  if (!assignee && assignee !== "") return undefined;
+  if (assignee === "") return null;
+  const rows = await sql`SELECT id, name FROM users WHERE name LIKE ${"%" + assignee + "%"} LIMIT 1`;
+  if (!rows.length) {
+    const users = await sql`SELECT name FROM users ORDER BY name`;
+    throw new Error(`担当者 "${assignee}" が見つかりません。登録済み: ${users.map(u => u.name).join(", ")}`);
+  }
+  return rows[0].id;
+}
+
+async function resolveParent(parent) {
+  if (!parent) return null;
+  const rows = await sql`SELECT id, key, parent_id FROM issues WHERE key = ${parent.toUpperCase()} LIMIT 1`;
+  if (!rows.length) throw new Error(`親課題 "${parent}" が見つかりません`);
+  if (rows[0].parent_id != null) throw new Error(`"${parent}" はすでに子課題です`);
+  return rows[0].id;
+}
+
+// ── listIssues ────────────────────────────────────────
+async function listIssues({ status, assignee, category, priority, all, parentKey } = {}) {
+  let query = `
+    SELECT i.key, i.title, i.status, i.priority, i.category, i.color, i.due_date,
+           u.name AS assignee_name, p.key AS parent_key
+    FROM issues i
+    LEFT JOIN users u ON u.id = i.assignee_id
+    LEFT JOIN issues p ON p.id = i.parent_id
+    WHERE 1=1
+  `;
+  const params = [];
+
+  if (status && status !== "all") {
+    params.push(status);
+    query += ` AND i.status = $${params.length}`;
+  } else if (!all) {
+    query += ` AND i.status IN ('未対応', '処理中')`;
+  }
+
+  if (assignee) {
+    params.push(`%${assignee}%`);
+    query += ` AND u.name LIKE $${params.length}`;
+  }
+
+  if (category) {
+    params.push(`%${category}%`);
+    query += ` AND i.category LIKE $${params.length}`;
+  }
+
+  if (priority) {
+    params.push(priority);
+    query += ` AND i.priority = $${params.length}`;
+  }
+
+  if (parentKey) {
+    params.push(parentKey.toUpperCase());
+    query += ` AND p.key = $${params.length}`;
+  }
+
+  query += ` ORDER BY COALESCE(i.parent_id, i.id) DESC, (i.parent_id IS NOT NULL), i.id ASC`;
+  return sql.unsafe(query, params);
+}
+
+// ── addIssue ──────────────────────────────────────────
+async function addIssue({ title, priority = "中", status = "未対応", assignee, parent, description = "", category, color }) {
+  const assigneeId = await resolveAssignee(assignee);
+  const parentId = await resolveParent(parent);
+  const key = await nextKey();
+  await sql`
+    INSERT INTO issues (key, title, description, status, priority, assignee_id, parent_id, category, color)
+    VALUES (${key}, ${title}, ${description}, ${status}, ${priority},
+            ${assigneeId ?? null}, ${parentId}, ${category || null}, ${color || null})
+  `;
+  return { key, title, status, priority, category, color };
+}
+
+// ── addBulk ───────────────────────────────────────────
+async function addBulk(issues) {
+  const results = [];
+  for (const issue of issues) {
+    try {
+      const result = await addIssue(issue);
+      results.push({ ok: true, ...result });
+    } catch (e) {
+      results.push({ ok: false, title: issue.title, error: e.message });
+    }
+  }
+  return results;
+}
+
+// ── updateIssue ───────────────────────────────────────
+async function updateIssue({ key, title, status, priority, assignee, category, color, description }) {
+  const rows = await sql`SELECT id FROM issues WHERE key = ${key.toUpperCase()} LIMIT 1`;
+  if (!rows.length) throw new Error(`課題 "${key}" が見つかりません`);
+  const id = rows[0].id;
+
+  const fields = {};
+  if (title !== undefined) fields.title = title;
+  if (status !== undefined) fields.status = status;
+  if (priority !== undefined) fields.priority = priority;
+  if (category !== undefined) fields.category = category || null;
+  if (color !== undefined) fields.color = color || null;
+  if (description !== undefined) fields.description = description;
+
+  if (assignee !== undefined) {
+    fields.assignee_id = assignee === "" ? null : (await resolveAssignee(assignee));
+  }
+
+  if (!Object.keys(fields).length) throw new Error("変更するフィールドを指定してください");
+  await sql`UPDATE issues SET ${sql(fields)} WHERE id = ${id}`;
+  return key.toUpperCase();
+}
+
+// ── updateBulk ────────────────────────────────────────
+async function updateBulk(issues) {
+  const results = [];
+  for (const issue of issues) {
+    try {
+      const key = await updateIssue(issue);
+      results.push({ ok: true, key });
+    } catch (e) {
+      results.push({ ok: false, key: issue.key, error: e.message });
+    }
+  }
+  return results;
+}
+
+// ── deleteIssue ───────────────────────────────────────
+async function deleteIssue(key) {
+  const rows = await sql`SELECT id, title FROM issues WHERE key = ${key.toUpperCase()} LIMIT 1`;
+  if (!rows.length) throw new Error(`課題 "${key}" が見つかりません`);
+  await sql`DELETE FROM issues WHERE key = ${key.toUpperCase()}`;
+  return { key: key.toUpperCase(), title: rows[0].title };
+}
+
+// ── deleteBulk ────────────────────────────────────────
+async function deleteBulk(keys) {
+  const results = [];
+  for (const key of keys) {
+    try {
+      const result = await deleteIssue(key);
+      results.push({ ok: true, ...result });
+    } catch (e) {
+      results.push({ ok: false, key, error: e.message });
+    }
+  }
+  return results;
+}
+
+// ── exec (batch) ──────────────────────────────────────
+async function exec({ add = [], update = [], delete: del = [] }) {
+  const results = {};
+  if (add.length) results.add = await addBulk(add);
+  if (update.length) results.update = await updateBulk(update);
+  if (del.length) results.delete = await deleteBulk(del);
+  return results;
+}
+
+// ── listUsers ─────────────────────────────────────────
+async function listUsers() {
+  return sql`SELECT id, name, color FROM users ORDER BY name`;
+}
+
+module.exports = { sql, listIssues, addIssue, addBulk, updateIssue, updateBulk, deleteIssue, deleteBulk, exec, listUsers };

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "easy-backlog-tools",
+  "version": "1.0.0",
+  "description": "MCP server and CLI for easy-backlog issue tracker",
+  "main": "index.js",
+  "bin": {
+    "easy-backlog-tools": "index.js"
+  },
+  "files": [
+    "index.js",
+    "server.js",
+    "cli.js",
+    "lib/"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "postgres": "^3.4.8",
+    "zod": "^3.24.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": ["mcp", "cli", "issue-tracker", "claude"],
+  "license": "MIT"
+}

package/server.js

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+/**
+ * easy-backlog MCP サーバー
+ */
+
+const { McpServer } = require("@modelcontextprotocol/sdk/server/mcp.js");
+const { StdioServerTransport } = require("@modelcontextprotocol/sdk/server/stdio.js");
+const { z } = require("zod");
+
+if (!process.env.DATABASE_URL) {
+  process.stderr.write("エラー: DATABASE_URL が設定されていません\n");
+  process.exit(1);
+}
+
+const { listIssues, addIssue, updateIssue, deleteIssue, listUsers } = require("./lib/db");
+
+const server = new McpServer({ name: "easy-backlog", version: "1.3.0" });
+
+const issueSchema = {
+  title: z.string().optional(),
+  priority: z.enum(["低", "中", "高", "緊急"]).optional().default("中"),
+  status: z.enum(["未対応", "処理中", "完了"]).optional().default("未対応"),
+  assignee: z.string().optional(),
+  parent: z.string().optional(),
+  description: z.string().optional().default(""),
+  category: z.string().optional(),
+  color: z.string().optional(),
+};
+
+const ok = (text) => ({ content: [{ type: "text", text }] });
+const err = (e) => ({ content: [{ type: "text", text: `エラー: ${e.message}` }] });
+
+// ── list_issues ───────────────────────────────────────
+server.tool("list_issues", "アクティブな課題を一覧表示する", {
+  status: z.enum(["未対応", "処理中", "完了", "all"]).optional(),
+  assignee: z.string().optional(),
+  all: z.boolean().optional(),
+}, async (args) => {
+  try {
+    const issues = await listIssues(args);
+    if (!issues.length) return ok("該当する課題はありません");
+    const lines = issues.map(i => {
+      const indent = i.parent_key ? "  └─ " : "";
+      const cat = i.category ? ` [${i.category}]` : "";
+      const who = i.assignee_name ? ` @${i.assignee_name}` : "";
+      const due = i.due_date ? ` 期限:${i.due_date}` : "";
+      return `${indent}${i.key} ${i.status} ${i.priority} | ${i.title}${cat}${who}${due}`;
+    });
+    return ok(lines.join("\n"));
+  } catch (e) { return err(e); }
+});
+
+// ── add_issue ─────────────────────────────────────────
+server.tool("add_issue", "課題を1件追加する", {
+  title: z.string(),
+  ...issueSchema,
+}, async (args) => {
+  try {
+    const { key, title, status, priority, category, color } = await addIssue(args);
+    const lines = [
+      `✓ 課題を追加しました`,
+      `  キー    : ${key}`,
+      `  タイトル: ${title}`,
+      `  状態    : ${status}`,
+      `  優先度  : ${priority}`,
+      category ? `  カテゴリ: ${category}` : null,
+      color ? `  カラー  : ${color}` : null,
+    ].filter(Boolean);
+    return ok(lines.join("\n"));
+  } catch (e) { return err(e); }
+});
+
+// ── add_issues_bulk ───────────────────────────────────
+server.tool("add_issues_bulk", "複数の課題を一括追加する", {
+  issues: z.array(z.object({ title: z.string(), ...issueSchema })),
+}, async ({ issues }) => {
+  const results = [];
+  for (const issue of issues) {
+    try {
+      const { key, title, category } = await addIssue(issue);
+      results.push(`✓ ${key} : ${title}${category ? ` [${category}]` : ""}`);
+    } catch (e) {
+      results.push(`✗ ${issue.title}: ${e.message}`);
+    }
+  }
+  return ok(results.join("\n"));
+});
+
+// ── update_issue ──────────────────────────────────────
+server.tool("update_issue", "課題を更新する", {
+  key: z.string(),
+  ...issueSchema,
+}, async (args) => {
+  try {
+    const key = await updateIssue(args);
+    return ok(`✓ ${key} を更新しました`);
+  } catch (e) { return err(e); }
+});
+
+// ── update_issues_bulk ────────────────────────────────
+server.tool("update_issues_bulk", "複数の課題を一括更新する", {
+  issues: z.array(z.object({ key: z.string(), ...issueSchema })),
+}, async ({ issues }) => {
+  const results = [];
+  for (const issue of issues) {
+    try {
+      const key = await updateIssue(issue);
+      results.push(`✓ ${key} を更新しました`);
+    } catch (e) {
+      results.push(`✗ ${issue.key}: ${e.message}`);
+    }
+  }
+  return ok(results.join("\n"));
+});
+
+// ── delete_issue ──────────────────────────────────────
+server.tool("delete_issue", "課題を削除する", {
+  key: z.string(),
+}, async ({ key }) => {
+  try {
+    const title = await deleteIssue(key);
+    return ok(`✓ ${key.toUpperCase()} "${title}" を削除しました`);
+  } catch (e) { return err(e); }
+});
+
+// ── delete_issues_bulk ────────────────────────────────
+server.tool("delete_issues_bulk", "複数の課題を一括削除する", {
+  keys: z.array(z.string()),
+}, async ({ keys }) => {
+  const results = [];
+  for (const key of keys) {
+    try {
+      const title = await deleteIssue(key);
+      results.push(`✓ ${key.toUpperCase()} "${title}" を削除しました`);
+    } catch (e) {
+      results.push(`✗ ${key}: ${e.message}`);
+    }
+  }
+  return ok(results.join("\n"));
+});
+
+// ── list_users ────────────────────────────────────────
+server.tool("list_users", "登録済みメンバーを一覧表示する", {}, async () => {
+  try {
+    const users = await listUsers();
+    if (!users.length) return ok("メンバーが登録されていません");
+    return ok(users.map(u => `${u.name} (id:${u.id}, color:${u.color})`).join("\n"));
+  } catch (e) { return err(e); }
+});
+
+// ── 起動 ──────────────────────────────────────────────
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  process.stderr.write("easy-backlog MCP サーバー起動\n");
+}
+
+main().catch(err => {
+  process.stderr.write(`エラー: ${err.message}\n`);
+  process.exit(1);
+});