@nocodelab/kadailog-mcp 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 deed LLC (ノーコードラボ)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,90 @@
-# Temporary Holding Version
+# @nocodelab/kadailog-mcp
+
+KadaiLog の公式 MCP サーバ。Claude Code / Codex などの AI エージェントから
+KadaiLog の課題を読み書きするためのものです。
+
+中身は KadaiLog の外部API(`/api/v1`)を叩くだけの薄いラッパーで、権限・入力検証・
+変更履歴・通知はすべて KadaiLog 本体が担当します。
+
+## 準備
+
+KadaiLog にサインインし、**個人設定 > APIキー** でキーを発行します
+(`tslg_…` で始まる文字列。表示されるのは発行直後の1回だけです)。
+
+キーは**発行した本人の権限で動きます**。参加していないプロジェクトは、
+このMCPサーバからも見えません。
+
+## 設定
+
+Claude Code の場合、`.mcp.json` か `~/.claude.json` に追加します。
+
+```json
+{
+  "mcpServers": {
+    "kadailog": {
+      "command": "npx",
+      "args": ["-y", "@nocodelab/kadailog-mcp"],
+      "env": {
+        "KADAILOG_API_KEY": "tslg_xxxxxxxxxxxx"
+      }
+    }
+  }
+}
+```
+
+| 環境変数 | 必須 | 説明 |
+| --- | --- | --- |
+| `KADAILOG_API_KEY` | ○ | 個人設定で発行したAPIキー |
+| `KADAILOG_API_URL` | | 接続先の上書き。既定は `https://api.kadailog.com/v1` |
+
+改名前の `TASKLOG_API_KEY` / `TASKLOG_API_URL` も当面は読みます(新しい名前が優先)。
+
+## ツール
+
+| ツール | できること |
+| --- | --- |
+| `get_myself` | 自分(APIキーの持ち主)の名前・権限とスペースの情報 |
+| `list_my_issues` | 自分の担当課題(全プロジェクト・期限が近い順) |
+| `list_notifications` | 自分宛ての通知(未読だけも可) |
+| `mark_notifications_read` | 通知を既読にする(課題ごと/全部) |
+| `list_projects` | 参加しているプロジェクトの一覧 |
+| `get_project_meta` | そのプロジェクトのステータス・種別・カテゴリ・マイルストーン・メンバー一覧 |
+| `list_issues` | 課題の絞り込み(担当者・ステータス・種別・マイルストーン・カテゴリ・更新日時・期限順など) |
+| `search_issues` | 件名・本文のキーワード検索(スペース全体・日本語可) |
+| `get_issue` | 課題1件の詳細(親子・関連課題・ウォッチ中かを含む) |
+| `get_issue_history` | 課題の変更履歴(だれが・いつ・何を変えたか) |
+| `list_recent_activities` | 最近の更新(課題の作成・更新・コメント)。「昨日から何が変わった?」用 |
+| `create_issue` | 課題の作成 |
+| `update_issue` | 課題の更新(ステータス変更・担当変更・期限設定など) |
+| `list_comments` | コメント一覧 |
+| `add_comment` | コメント追加 |
+| `list_wiki_pages` | Wikiページの一覧・キーワード検索 |
+| `get_wiki_page` | Wikiページの本文 |
+| `create_wiki_page` | Wikiページの作成 |
+| `update_wiki_page` | Wikiページのタイトル・本文の更新 |
+
+課題は課題キー(`RENEW-12`)、プロジェクトはプロジェクトキー(`RENEW`)、Wikiページは
+プロジェクトキー+タイトルで指定します。
+ステータス・種別などはプロジェクトごとに違うため、名前で指定し、間違えると**候補付きの
+エラー**が返ります(エージェントはそれを見て言い直せます)。
+
+一覧系(`list_issues` / `list_my_issues` / `list_notifications` / `list_recent_activities` /
+`list_wiki_pages`)は、結果の `nextCursor` を次の呼び出しの `cursor` に渡すと続きを取れます
+(`null` なら続きなし)。
+
+## 注意
+
+- 画面から操作したときと同じように、**変更履歴に残り、関係者に通知が飛びます**
+  (変更履歴には API 経由であることも記録されます)
+- 添付ファイルには対応していません。Wiki の削除もできません(画面から行ってください)
+- レート制限は 1キーあたり 60リクエスト/分
+
+## 開発
+
+```bash
+npm install
+npm run build
+```
+
+`KADAILOG_API_URL` に開発環境の URL を渡せば、そちらに向けて動作確認できます。
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.

package/dist/index.js

@@ -0,0 +1,358 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createRequire } from "node:module";
+import { z } from "zod";
+const DEFAULT_API_URL = "https://api.kadailog.com/v1";
+const API_URL = (process.env.KADAILOG_API_URL ||
+    process.env.TASKLOG_API_URL ||
+    DEFAULT_API_URL).replace(/\/+$/, "");
+const API_KEY = process.env.KADAILOG_API_KEY || process.env.TASKLOG_API_KEY;
+if (!API_KEY) {
+    console.error("KADAILOG_API_KEY が設定されていません。KadaiLog の「個人設定 > APIキー」で発行し、" +
+        "MCPサーバの env に設定してください。");
+    process.exit(1);
+}
+function ok(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}
+function fail(message) {
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+async function request(method, path, options = {}) {
+    const url = new URL(API_URL + path);
+    for (const [key, value] of Object.entries(options.query ?? {})) {
+        if (value !== undefined && value !== null && value !== "") {
+            url.searchParams.set(key, String(value));
+        }
+    }
+    let response;
+    try {
+        response = await fetch(url, {
+            method,
+            headers: {
+                authorization: `Bearer ${API_KEY}`,
+                ...(options.body === undefined
+                    ? {}
+                    : { "content-type": "application/json" }),
+            },
+            body: options.body === undefined ? undefined : JSON.stringify(options.body),
+        });
+    }
+    catch (err) {
+        return fail(`KadaiLog に接続できませんでした (${API_URL}): ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const text = await response.text();
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return fail(`KadaiLog から予期しない応答が返りました: ${text.slice(0, 300)}`);
+    }
+    if (!response.ok) {
+        const error = parsed
+            .error;
+        return fail(`${error?.message ?? "エラーが発生しました"} (${error?.code ?? response.status})`);
+    }
+    return ok(parsed);
+}
+const { version } = createRequire(import.meta.url)("../package.json");
+const server = new McpServer({ name: "kadailog", version });
+const issueKey = z
+    .string()
+    .describe("課題キー。例: RENEW-12(list_issues や search_issues の key)");
+const projectKey = z
+    .string()
+    .describe("プロジェクトキー。例: RENEW(list_projects の key)");
+const statusArg = z
+    .string()
+    .optional()
+    .describe("ステータスの名前。プロジェクト固有なので get_project_meta で確認すること");
+const typeArg = z
+    .string()
+    .optional()
+    .describe("種別の名前。プロジェクト固有なので get_project_meta で確認すること");
+const priorityArg = z
+    .enum(["high", "medium", "low"])
+    .optional()
+    .describe("優先度。省略時は medium");
+const assigneeArg = z
+    .string()
+    .optional()
+    .describe("担当者。メールアドレスか表示名、自分自身なら \"me\"。update_issue で空文字を渡すと担当を外す");
+const dueDateArg = z
+    .string()
+    .optional()
+    .describe("期限日 YYYY-MM-DD。update_issue で空文字を渡すと期限を外す");
+const categoriesArg = z
+    .array(z.string())
+    .optional()
+    .describe("カテゴリ名の配列。指定した内容で置き換わる");
+const milestonesArg = z
+    .array(z.string())
+    .optional()
+    .describe("マイルストーン名の配列。指定した内容で置き換わる");
+const versionsArg = z
+    .array(z.string())
+    .optional()
+    .describe("発生バージョン名の配列。指定した内容で置き換わる。マスタはマイルストーンと共通" +
+    "(get_project_meta の milestones)。features.versions が ON のプロジェクトで使う");
+const parentArg = z
+    .string()
+    .optional()
+    .describe("親課題の課題キー(例 RENEW-12)。同じプロジェクトの課題のみ・階層は1段まで" +
+    "(親を持つ課題は親になれない)。update_issue で空文字を渡すと親子関係を外す");
+const limitArg = (fallback) => z.number().optional().describe(`最大件数(既定${fallback}・上限100)`);
+const cursorArg = z
+    .string()
+    .optional()
+    .describe("続きを取るときに、前回の結果の nextCursor をそのまま渡す。nextCursor が null なら続きはない" +
+    "(0件でも nextCursor があれば、まだ続きがある)");
+const wikiTitleArg = z
+    .string()
+    .describe("Wikiページのタイトル。「/」区切りは階層(例: 10. 概要/01. 用語集)。list_wiki_pages の title をそのまま渡す");
+server.registerTool("get_myself", {
+    title: "自分の情報",
+    description: "このAPIキーの持ち主(自分)の表示名・メールアドレス・権限と、スペースの名前・URLを返す。" +
+        "「自分の〜」を扱うときの起点。",
+    inputSchema: {},
+}, async () => await request("GET", "/me"));
+server.registerTool("list_projects", {
+    title: "プロジェクト一覧",
+    description: "参加しているプロジェクトの一覧を返す。他のツールに渡すプロジェクトキーはここで調べる。",
+    inputSchema: {},
+}, async () => await request("GET", "/projects"));
+server.registerTool("get_project_meta", {
+    title: "プロジェクトの設定値",
+    description: "プロジェクトで使えるステータス・種別・カテゴリ・マイルストーン・メンバーの一覧を返す。" +
+        "ステータスや種別はプロジェクトごとに違うので、create_issue / update_issue の前にこれで確認すること。" +
+        "どのステータスが「完了」扱いかも isDone で分かる。",
+    inputSchema: { project: projectKey },
+}, async ({ project }) => await request("GET", `/projects/${encodeURIComponent(project)}/meta`));
+server.registerTool("list_issues", {
+    title: "課題の一覧・絞り込み",
+    description: "課題を条件で絞り込んで返す。project を指定するのが基本。" +
+        "project を省略できるのは assignee を指定し state が open か closed のときだけ" +
+        "(プロジェクト横断で「自分の未完了課題」を見る用途)。" +
+        "キーワードで探したいだけなら search_issues の方が適している。",
+    inputSchema: {
+        project: projectKey.optional(),
+        assignee: z
+            .string()
+            .optional()
+            .describe("担当者で絞る。メールアドレス・表示名・\"me\"、未割り当ては \"none\""),
+        state: z
+            .enum(["open", "closed", "all"])
+            .optional()
+            .describe("未完了 open(既定) / 完了 closed / 全部 all"),
+        status: statusArg,
+        type: typeArg,
+        milestone: z.string().optional().describe("マイルストーン名で絞る"),
+        version: z.string().optional().describe("発生バージョン名で絞る"),
+        category: z.string().optional().describe("カテゴリ名で絞る"),
+        q: z
+            .string()
+            .optional()
+            .describe("件名・本文の部分一致で絞る(単純な部分一致。全文検索は search_issues)"),
+        sort: z
+            .enum(["updated", "due", "key"])
+            .optional()
+            .describe("並び順。updated=更新新しい順(既定) / due=期限近い順 / key=キー順。" +
+            "cursor で全件をたどるときは、途中の更新で順番がずれない key を使う"),
+        updatedSince: z
+            .string()
+            .optional()
+            .describe("この日時以降に更新された課題だけ(ISO 8601。例 2026-10-11T09:00:00+09:00。時差を省くと日本時間)"),
+        limit: limitArg(50),
+        cursor: cursorArg,
+    },
+}, async (args) => await request("GET", "/issues", { query: args }));
+server.registerTool("list_my_issues", {
+    title: "自分の担当課題",
+    description: "自分が担当の課題を、参加している全プロジェクトから期限が近い順に返す(期限なしは後ろ)。" +
+        "「今日やること」「自分のタスク」を聞かれたらまずこれ。",
+    inputSchema: {
+        state: z
+            .enum(["open", "closed"])
+            .optional()
+            .describe("未完了 open(既定) / 完了 closed"),
+        sort: z
+            .enum(["due", "updated", "key"])
+            .optional()
+            .describe("並び順。due=期限近い順(既定) / updated=更新新しい順 / key=キー順。" +
+            "cursor で全件をたどるときは、途中の更新で順番がずれない key を使う"),
+        limit: limitArg(50),
+        cursor: cursorArg,
+    },
+}, async ({ state, sort, limit, cursor }) => await request("GET", "/issues", {
+    query: {
+        assignee: "me",
+        state: state ?? "open",
+        sort: sort ?? "due",
+        limit,
+        cursor,
+    },
+}));
+server.registerTool("search_issues", {
+    title: "課題の全文検索",
+    description: "スペース全体の課題を件名・本文のキーワードで検索する。日本語もそのまま渡してよい(2文字以上)。" +
+        "プロジェクトやステータスが分かっているなら list_issues の方が確実。",
+    inputSchema: {
+        q: z.string().describe("検索キーワード(2文字以上)"),
+        limit: z.number().optional().describe("最大件数(既定20・上限100)"),
+    },
+}, async ({ q, limit }) => await request("GET", "/search", { query: { q, limit } }));
+server.registerTool("get_issue", {
+    title: "課題の詳細",
+    description: "課題キーを指定して1件の詳細を返す。親課題(parent)・子課題の一覧(children)・関連課題の一覧(related)・自分がウォッチ中か(watching)も含まれる。",
+    inputSchema: { key: issueKey },
+}, async ({ key }) => await request("GET", `/issues/${encodeURIComponent(key)}`));
+server.registerTool("create_issue", {
+    title: "課題を作成",
+    description: "課題を新規作成する。status / type / categories / milestones はプロジェクト固有の名前なので、" +
+        "自信がなければ先に get_project_meta を呼ぶこと。省略時は先頭のステータス・種別・優先度 medium になる。" +
+        "担当者を指定すると、その人に通知とメールが飛ぶ。",
+    inputSchema: {
+        project: projectKey,
+        title: z.string().describe("件名"),
+        description: z.string().optional().describe("本文(Markdown)"),
+        status: statusArg,
+        type: typeArg,
+        priority: priorityArg,
+        assignee: assigneeArg,
+        dueDate: dueDateArg,
+        categories: categoriesArg,
+        milestones: milestonesArg,
+        versions: versionsArg,
+        parent: parentArg,
+    },
+}, async (args) => await request("POST", "/issues", { body: args }));
+server.registerTool("update_issue", {
+    title: "課題を更新",
+    description: "課題の項目を変更する。渡した項目だけが変わり、省略した項目はそのまま。" +
+        "課題を閉じるには status に「完了」扱いのステータス名を渡す(どれが完了扱いかは get_project_meta の isDone)。" +
+        "担当・期限・親課題を外したいときは空文字 \"\" を渡す。変更は課題の変更履歴に残り、関係者に通知される。",
+    inputSchema: {
+        key: issueKey,
+        title: z.string().optional().describe("件名"),
+        description: z.string().optional().describe("本文(Markdown)。全文が置き換わる"),
+        status: statusArg,
+        type: typeArg,
+        priority: priorityArg,
+        assignee: assigneeArg,
+        dueDate: dueDateArg,
+        categories: categoriesArg,
+        milestones: milestonesArg,
+        versions: versionsArg,
+        parent: parentArg,
+    },
+}, async ({ key, ...body }) => await request("PATCH", `/issues/${encodeURIComponent(key)}`, { body }));
+server.registerTool("get_issue_history", {
+    title: "課題の変更履歴",
+    description: "課題の変更履歴(だれが・いつ・何を変えたか)を古い順に返す。ステータス・担当者・期限日などの変更が分かる。" +
+        "via は app=画面から / api=外部API・MCP から。コメントは含まないので list_comments を使う。",
+    inputSchema: { key: issueKey },
+}, async ({ key }) => await request("GET", `/issues/${encodeURIComponent(key)}/history`));
+server.registerTool("list_recent_activities", {
+    title: "最近の更新",
+    description: "スペース(または指定プロジェクト)の最近の更新を新しい順に返す。課題の作成・更新(変更内容つき)とコメント追加。" +
+        "「昨日から何が変わった?」は since に昨日の日時を渡す。コメントは先頭300文字まで(全文は list_comments)。" +
+        "Backlog から移行したコメントは含まない。" +
+        "同じ人が10分以内に続けて変えた内容は1件にまとまり、時刻は最初の変更のもの" +
+        "(短い間隔で since を進めながら見張ると取りこぼすことがあるので、見張る用途は少し前から重ねて取る)。",
+    inputSchema: {
+        project: projectKey.optional().describe("プロジェクトキーで絞る(省略=参加している全プロジェクト)"),
+        since: z
+            .string()
+            .optional()
+            .describe("この日時より後の更新だけ(ISO 8601。例 2026-10-10T00:00:00+09:00。時差を省くと日本時間)"),
+        limit: limitArg(30),
+        cursor: cursorArg,
+    },
+}, async (args) => await request("GET", "/activities", { query: args }));
+server.registerTool("list_notifications", {
+    title: "自分宛ての通知",
+    description: "自分宛ての通知(メンション・担当に設定・ウォッチ中の課題のコメントなど)を新しい順に返す。" +
+        "確認し終えたら mark_notifications_read で既読にできる。",
+    inputSchema: {
+        unread: z.boolean().optional().describe("true=未読だけ"),
+        limit: limitArg(20),
+        cursor: cursorArg,
+    },
+}, async (args) => await request("GET", "/notifications", { query: args }));
+server.registerTool("mark_notifications_read", {
+    title: "通知を既読にする",
+    description: "通知を既読にする。issue に課題キーを渡すとその課題の通知だけ、all=true で全部。" +
+        "画面の未読表示にも反映されるので、利用者が確認したと言ったとき・確認を頼まれたときに使う。",
+    inputSchema: {
+        issue: issueKey.optional(),
+        all: z.boolean().optional().describe("true=すべての未読通知を既読にする"),
+    },
+}, async (body) => await request("POST", "/notifications/read", { body }));
+server.registerTool("list_wiki_pages", {
+    title: "Wikiページの一覧",
+    description: "プロジェクトのWikiページの一覧(タイトル順・本文なし)を返す。タイトルの「/」区切りは階層。" +
+        "q でタイトル・本文の部分一致検索もできる。本文は get_wiki_page で読む。",
+    inputSchema: {
+        project: projectKey,
+        q: z.string().optional().describe("タイトル・本文の部分一致で絞る"),
+        limit: limitArg(50),
+        cursor: cursorArg,
+    },
+}, async ({ project, ...query }) => await request("GET", `/projects/${encodeURIComponent(project)}/wiki`, { query }));
+server.registerTool("get_wiki_page", {
+    title: "Wikiページを読む",
+    description: "Wikiページの本文(Markdown)を返す。ページはプロジェクトキーとタイトルで指定する。",
+    inputSchema: { project: projectKey, title: wikiTitleArg },
+}, async ({ project, title }) => await request("GET", `/projects/${encodeURIComponent(project)}/wiki/page`, {
+    query: { title },
+}));
+server.registerTool("create_wiki_page", {
+    title: "Wikiページを作成",
+    description: "Wikiページを新しく作る。同じタイトルのページがあるとエラーになる(そのときは update_wiki_page)。" +
+        "階層の下に作るときはタイトルを「親/子」の形にする。",
+    inputSchema: {
+        project: projectKey,
+        title: z.string().describe("タイトル。「/」区切りで階層になる"),
+        body: z.string().optional().describe("本文(Markdown)"),
+    },
+}, async ({ project, title, body }) => await request("POST", `/projects/${encodeURIComponent(project)}/wiki`, {
+    body: { title, body },
+}));
+server.registerTool("update_wiki_page", {
+    title: "Wikiページを更新",
+    description: "Wikiページのタイトルや本文を変える。body を渡すと本文の全文が置き換わる" +
+        "(追記したいときは先に get_wiki_page で読み、全文を組み立てて渡す)。版の管理はないので、" +
+        "読んだときの updatedAt を expectedUpdatedAt に渡すこと(その後にだれかが更新していたら止まる)。",
+    inputSchema: {
+        project: projectKey,
+        title: wikiTitleArg,
+        newTitle: z.string().optional().describe("新しいタイトル(変えるときだけ)"),
+        body: z.string().optional().describe("新しい本文(Markdown)。全文が置き換わる"),
+        expectedUpdatedAt: z
+            .string()
+            .optional()
+            .describe("get_wiki_page で読んだときの updatedAt。食い違えば更新せずエラーになる"),
+    },
+}, async ({ project, title, newTitle, body, expectedUpdatedAt }) => await request("PATCH", `/projects/${encodeURIComponent(project)}/wiki/page`, {
+    query: { title },
+    body: { title: newTitle, body, expectedUpdatedAt },
+}));
+server.registerTool("list_comments", {
+    title: "コメント一覧",
+    description: "課題に付いたコメントを古い順に返す。",
+    inputSchema: { key: issueKey },
+}, async ({ key }) => await request("GET", `/issues/${encodeURIComponent(key)}/comments`));
+server.registerTool("add_comment", {
+    title: "コメントを追加",
+    description: "課題にコメントを追加する。本文で @表示名 と書くとその人にメンション通知が飛ぶ。",
+    inputSchema: {
+        key: issueKey,
+        body: z.string().describe("コメント本文(Markdown)"),
+    },
+}, async ({ key, body }) => await request("POST", `/issues/${encodeURIComponent(key)}/comments`, {
+    body: { body },
+}));
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/package.json

@@ -1,6 +1,39 @@
 {
   "name": "@nocodelab/kadailog-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "KadaiLog の公式MCPサーバ。Claude Code などのAIエージェントから課題を操作する",
+  "homepage": "https://docs.kadailog.com/advanced/ai-agents/",
+  "keywords": [
+    "mcp",
+    "kadailog",
+    "model-context-protocol",
+    "claude",
+    "task-management"
+  ],
+  "type": "module",
+  "bin": {
+    "kadailog-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^26.2.0",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}