@ignission/slack-task-mcp 0.1.0

package/README.ja.md

@@ -0,0 +1,112 @@
+# slack-task-mcp
+
+Slack タスク管理 MCP サーバー for Claude Code / Claude Desktop
+
+[![npm version](https://badge.fury.io/js/slack-task-mcp.svg)](https://www.npmjs.com/package/slack-task-mcp)
+
+[English](./README.md)
+
+## こんな人向け
+
+- Slackのメンションがたまると、どこから手を付けていいか迷う
+- 難しい依頼が来ると、何を聞けばいいかわからず固まる
+- 返信を書くのに時間がかかる
+- タスクを分解しても、途中で集中が切れて諦めてしまう
+
+## インストール
+
+```bash
+# 認証（初回のみ）
+npx slack-task-mcp auth
+
+# 認証状態を確認
+npx slack-task-mcp auth status
+```
+
+## Claude Desktop 設定
+
+### macOS
+
+`~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "slack-task": {
+      "command": "npx",
+      "args": ["-y", "slack-task-mcp"]
+    }
+  }
+}
+```
+
+### Windows
+
+`%APPDATA%\Claude\claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "slack-task": {
+      "command": "npx.cmd",
+      "args": ["-y", "slack-task-mcp"]
+    }
+  }
+}
+```
+
+設定後、Claude Desktopを再起動してください。
+
+## 機能
+
+| ツール | 説明 |
+|--------|------|
+| `get_slack_thread` | SlackスレッドURLからメッセージを取得 |
+| `analyze_request` | 依頼を分析し、目的・不明点・確認案を生成 |
+| `draft_reply` | 返信を添削し、ロジカルに構造化 |
+| `save_task` | タスクを保存（5分以内のステップに分解） |
+| `list_tasks` | タスク一覧を表示 |
+| `search_tasks` | キーワード・日付でタスクを検索 |
+| `complete_step` | ステップを完了にする |
+| `search_slack` | Slackメッセージをキーワードで検索 |
+
+## 使い方
+
+### Slackスレッドを分析
+
+```
+このスレッドを分析して: https://xxx.slack.com/archives/C12345678/p1234567890
+```
+
+### タスクとして保存
+
+```
+5分以内のステップに分解して保存して
+```
+
+### 返信を添削
+
+```
+この返信を添削して「レポートできました。確認お願いします。」
+```
+
+## CLIコマンド
+
+```bash
+npx slack-task-mcp auth          # 認証
+npx slack-task-mcp auth status   # 認証状態を確認
+npx slack-task-mcp auth logout   # ログアウト
+npx slack-task-mcp --help        # ヘルプ
+```
+
+## データ保存先
+
+```
+~/.slack-task-mcp/
+├── credentials.json  # 認証情報
+└── tasks.json        # タスクデータ
+```
+
+## ライセンス
+
+MIT

package/README.md

@@ -0,0 +1,112 @@
+# slack-task-mcp
+
+Slack Task Management MCP Server for Claude Code / Claude Desktop
+
+[![npm version](https://badge.fury.io/js/slack-task-mcp.svg)](https://www.npmjs.com/package/slack-task-mcp)
+
+[日本語](./README.ja.md)
+
+## Who is this for?
+
+- You get overwhelmed when Slack mentions pile up
+- You freeze when complex requests come in, unsure what to ask
+- Writing replies takes too long
+- You break down tasks but lose focus midway
+
+## Installation
+
+```bash
+# Authenticate (first time only)
+npx slack-task-mcp auth
+
+# Check authentication status
+npx slack-task-mcp auth status
+```
+
+## Claude Desktop Configuration
+
+### macOS
+
+`~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "slack-task": {
+      "command": "npx",
+      "args": ["-y", "slack-task-mcp"]
+    }
+  }
+}
+```
+
+### Windows
+
+`%APPDATA%\Claude\claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "slack-task": {
+      "command": "npx.cmd",
+      "args": ["-y", "slack-task-mcp"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop after configuration.
+
+## Features
+
+| Tool | Description |
+|------|-------------|
+| `get_slack_thread` | Fetch messages from a Slack thread URL |
+| `analyze_request` | Analyze requests and generate purpose, questions, and confirmation messages |
+| `draft_reply` | Edit and structure replies logically |
+| `save_task` | Save tasks (broken into 5-minute steps) |
+| `list_tasks` | Display task list |
+| `search_tasks` | Search tasks by keyword or date |
+| `complete_step` | Mark a step as complete |
+| `search_slack` | Search Slack messages by keyword |
+
+## Usage
+
+### Analyze a Slack thread
+
+```
+Analyze this thread: https://xxx.slack.com/archives/C12345678/p1234567890
+```
+
+### Save as a task
+
+```
+Break this down into 5-minute steps and save it
+```
+
+### Edit a reply
+
+```
+Edit this reply: "The report is done. Please check it."
+```
+
+## CLI Commands
+
+```bash
+npx slack-task-mcp auth          # Authenticate
+npx slack-task-mcp auth status   # Check auth status
+npx slack-task-mcp auth logout   # Logout
+npx slack-task-mcp --help        # Help
+```
+
+## Data Storage
+
+```
+~/.slack-task-mcp/
+├── credentials.json  # Authentication credentials
+└── tasks.json        # Task data
+```
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@ignission/slack-task-mcp",
+  "version": "0.1.0",
+  "description": "MCP Server for Slack task management with Claude Code",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "slack-task-mcp": "./src/cli.js"
+  },
+  "files": [
+    "src"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ignission/slack-task-mcp.git"
+  },
+  "homepage": "https://github.com/ignission/slack-task-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/ignission/slack-task-mcp/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "slack",
+    "claude",
+    "task-management",
+    "model-context-protocol"
+  ],
+  "author": "Ignission G.K.",
+  "license": "MIT",
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.1.76",
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "@slack/web-api": "^7.13.0",
+    "open": "^10.1.0",
+    "zod": "^4.2.1"
+  }
+}

package/src/agents/analyze.js

@@ -0,0 +1,109 @@
+/**
+ * 分析エージェント
+ *
+ * Slackスレッドの依頼を分析し、目的・不明点・確認案・優先度を生成
+ */
+
+import { query } from "@anthropic-ai/claude-agent-sdk";
+import { z } from "zod";
+import {
+  ANALYZE_SYSTEM_PROMPT,
+  AGENT_TIMEOUT_MS,
+  createAgentOptions,
+  formatAgentError,
+} from "./index.js";
+
+// ============================================
+// 分析結果スキーマ（バリデーション用）
+// ============================================
+
+const UnclearPointSchema = z.object({
+  question: z.string().describe("確認すべき質問"),
+  impact: z.string().describe("この点が不明だと何が困るか"),
+  suggested_options: z.array(z.string()).optional().describe("想定される選択肢"),
+});
+
+const NextActionSchema = z.object({
+  action: z.string().describe("具体的なアクション内容"),
+  estimated_time: z.number().describe("推定所要時間（分）"),
+  reason: z.string().nullable().optional().describe("なぜこれが最初のアクションなのか"),
+});
+
+const PrioritySchema = z.enum(["high", "medium", "low"]);
+
+export const AnalysisResultSchema = z.object({
+  purpose: z.string().describe("依頼の目的（1文で言語化）"),
+  deliverable: z.string().nullable().optional().describe("成果物"),
+  deadline: z.string().nullable().optional().describe("期限"),
+  unclear_points: z.array(UnclearPointSchema).describe("不明点のリスト"),
+  confirmation_message: z.string().nullable().optional().describe("確認メッセージ案"),
+  next_action: NextActionSchema.describe("ネクストアクション"),
+  priority: PrioritySchema.describe("優先度"),
+});
+
+/**
+ * Slackスレッドの依頼を分析
+ *
+ * @param {string} threadContent - スレッドの内容
+ * @param {string} [threadUrl] - スレッドのURL（参照用）
+ * @returns {Promise<object>} 分析結果
+ * @throws {Error} エージェント実行エラーまたはバリデーションエラー
+ */
+export async function analyzeRequest(threadContent, threadUrl) {
+  const options = createAgentOptions(ANALYZE_SYSTEM_PROMPT);
+
+  // タイムアウト用のAbortController
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), AGENT_TIMEOUT_MS);
+
+  try {
+    const prompt = threadUrl
+      ? `以下のSlackスレッド（${threadUrl}）を分析してください:\n\n${threadContent}`
+      : `以下のSlackスレッドを分析してください:\n\n${threadContent}`;
+
+    const queryGenerator = query({
+      prompt,
+      options: {
+        ...options,
+        signal: controller.signal,
+      },
+    });
+
+    // AsyncGeneratorからresultメッセージを取得
+    let resultText = "";
+    for await (const message of queryGenerator) {
+      if (message.type === "result" && message.subtype === "success") {
+        resultText = message.result;
+        break;
+      }
+    }
+
+    if (!resultText) {
+      throw new Error("分析結果が取得できませんでした");
+    }
+
+    // レスポンスからJSON部分を抽出
+    const jsonMatch = resultText.match(/\{[\s\S]*\}/);
+    if (!jsonMatch) {
+      throw new Error("分析結果のJSONが見つかりませんでした");
+    }
+
+    // JSONパースとバリデーション
+    const parsed = JSON.parse(jsonMatch[0]);
+    const validated = AnalysisResultSchema.parse(parsed);
+
+    return validated;
+  } catch (error) {
+    if (error.name === "AbortError") {
+      throw new Error("処理がタイムアウトしました。再試行してください。");
+    }
+
+    if (error.name === "ZodError") {
+      throw new Error(`分析結果の形式が不正です: ${error.message}`);
+    }
+
+    throw new Error(formatAgentError(error));
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}

package/src/agents/draft-reply.js

@@ -0,0 +1,119 @@
+/**
+ * 返信添削エージェント
+ *
+ * 下書きを添削し、テンプレートに沿った構造化返信を生成
+ */
+
+import { query } from "@anthropic-ai/claude-agent-sdk";
+import { z } from "zod";
+import {
+  DRAFT_REPLY_SYSTEM_PROMPT,
+  AGENT_TIMEOUT_MS,
+  createAgentOptions,
+  formatAgentError,
+} from "./index.js";
+
+// ============================================
+// 返信添削結果スキーマ（バリデーション用）
+// ============================================
+
+const TaskTypeSchema = z.enum(["report", "confirm", "request"]);
+const ToneSchema = z.enum(["formal", "casual"]);
+const ChangeTypeSchema = z.enum(["structure", "simplify", "clarify", "tone", "logic", "add"]);
+
+const ChangeSchema = z.object({
+  type: ChangeTypeSchema.describe("変更の種類"),
+  description: z.string().describe("変更内容の説明"),
+  reason: z.string().describe("変更の理由"),
+});
+
+const ReplyStructureSchema = z.object({
+  conclusion: z.string().describe("結論（何を伝えたいか）"),
+  reasoning: z.string().nullable().optional().describe("根拠（なぜそう言えるか）"),
+  action: z.string().nullable().optional().describe("アクション"),
+});
+
+export const EditedReplySchema = z.object({
+  task_type: TaskTypeSchema.describe("タスクタイプ"),
+  after: z.string().describe("添削後のテキスト"),
+  structure: ReplyStructureSchema.describe("構造化された返信"),
+  changes: z.array(ChangeSchema).describe("変更ポイント"),
+  tone: ToneSchema.describe("適用されたトーン"),
+});
+
+/**
+ * 返信を添削
+ *
+ * @param {string} draftText - 添削対象の下書き
+ * @param {string} [threadContent] - 文脈用のスレッド内容
+ * @param {string} [taskType] - タスクタイプ（report/confirm/request）
+ * @param {string} [tone] - トーン（formal/casual）
+ * @returns {Promise<object>} 添削結果
+ * @throws {Error} エージェント実行エラーまたはバリデーションエラー
+ */
+export async function draftReply(draftText, threadContent, taskType, tone = "formal") {
+  const options = createAgentOptions(DRAFT_REPLY_SYSTEM_PROMPT);
+
+  // タイムアウト用のAbortController
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), AGENT_TIMEOUT_MS);
+
+  try {
+    let prompt = `以下の下書きを添削してください:\n\n「${draftText}」`;
+
+    if (threadContent) {
+      prompt += `\n\n文脈となるスレッド内容:\n${threadContent}`;
+    }
+
+    if (taskType) {
+      prompt += `\n\nタスクタイプ: ${taskType}`;
+    }
+
+    prompt += `\n\nトーン: ${tone}`;
+
+    const queryGenerator = query({
+      prompt,
+      options: {
+        ...options,
+        signal: controller.signal,
+      },
+    });
+
+    // AsyncGeneratorからresultメッセージを取得
+    let resultText = "";
+    for await (const message of queryGenerator) {
+      if (message.type === "result" && message.subtype === "success") {
+        resultText = message.result;
+        break;
+      }
+    }
+
+    if (!resultText) {
+      throw new Error("添削結果が取得できませんでした");
+    }
+
+    // レスポンスからJSON部分を抽出
+    const jsonMatch = resultText.match(/\{[\s\S]*\}/);
+    if (!jsonMatch) {
+      throw new Error("添削結果のJSONが見つかりませんでした");
+    }
+
+    // JSONパースとバリデーション
+    const parsed = JSON.parse(jsonMatch[0]);
+    const validated = EditedReplySchema.parse(parsed);
+
+    return validated;
+  } catch (error) {
+    if (error.name === "AbortError") {
+      throw new Error("処理がタイムアウトしました。再試行してください。");
+    }
+
+    if (error.name === "ZodError") {
+      throw new Error(`添削結果の形式が不正です: ${error.message}`);
+    }
+
+    throw new Error(formatAgentError(error));
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}

package/src/agents/index.js

@@ -0,0 +1,161 @@
+/**
+ * Agent SDK 共通設定
+ *
+ * エージェントのシステムプロンプトとオプションを定義
+ */
+
+// 分析エージェント用システムプロンプト
+export const ANALYZE_SYSTEM_PROMPT = `あなたはSlackの依頼を分析するエキスパートです。
+ADHDの特性を持つユーザーが、メンションから着手までスムーズに進められるよう支援します。
+
+## 分析ルール
+
+### 1. 目的の明確化
+「結局何を求められているか」を1文で言語化する。
+- この依頼の最終ゴールは何か？
+- 何を作る/する必要があるか？
+- 誰のため？誰と連携？
+
+### 2. 不明点の洗い出し
+「これを聞かないと進めない」を特定する。
+- 依頼文から読み取れない情報をリストアップ
+- 「たぶんこうだろう」で進めると手戻りになる点を特定
+- 不明点がある場合は、確認メッセージ案を提示
+
+### 3. 確認メッセージ案
+Slackで聞く文面まで生成する。
+- 簡潔で具体的な質問文
+- 相手が答えやすい選択肢を提示
+- 背景説明は最小限に
+
+### 4. タスク分解
+5分以内で完了できる粒度に分解する。
+- 最初のステップは最も簡単で、すぐ終わるものにする
+- 各ステップは「やった感」が得られる区切りにする
+- 途中で止めてもOKな区切りを明示する
+- 曖昧な作業は具体的な動作に変換する
+  - ❌「資料を作る」
+  - ✅「Googleドキュメントを開いてタイトルを書く」
+
+### 5. 優先度の判定
+- 🔴 高: 他の人をブロックしている、期限が近い
+- 🟡 中: 今日〜今週中にやるべき
+- 🟢 低: いつでもいい
+
+## 出力形式
+
+以下のJSON形式で出力してください：
+{
+  "purpose": "依頼の目的（1文）",
+  "deliverable": "成果物（あれば）",
+  "deadline": "期限（あれば）",
+  "unclear_points": [
+    {
+      "question": "確認すべき質問",
+      "impact": "不明だと何が困るか",
+      "suggested_options": ["選択肢1", "選択肢2"]
+    }
+  ],
+  "confirmation_message": "確認メッセージ案（不明点がある場合）",
+  "next_action": {
+    "action": "最初にやるべきこと",
+    "estimated_time": 5,
+    "reason": "なぜこれが最初か"
+  },
+  "priority": "high" | "medium" | "low"
+}`;
+
+// 返信添削エージェント用システムプロンプト
+export const DRAFT_REPLY_SYSTEM_PROMPT = `あなたはSlackの返信を添削するエキスパートです。
+ユーザーの下書きを、論理的で読みやすい構造に整理します。
+
+## 添削のポイント
+
+- **構造化**: 結論→根拠→アクションの順に整理
+- **簡潔化**: 冗長な表現を要点を絞った文章に変換
+- **ロジカルチェック**: 論理の飛躍や抜け漏れを指摘
+
+## タスクタイプ別テンプレート
+
+### 報告系
+\`\`\`
+<結論>〇〇の結果、△△となりました。
+<詳細>
+- ポイント1
+- ポイント2
+<次のアクション>□□をお願いできますでしょうか。
+\`\`\`
+
+### 確認系
+\`\`\`
+<確認したいこと>〇〇について確認させてください。
+<背景>△△のため、□□を決める必要があります。
+<質問>A案とB案のどちらで進めればよいでしょうか？
+\`\`\`
+
+### 依頼系
+\`\`\`
+<お願い>〇〇をお願いできますでしょうか。
+<背景>△△のため、□□が必要です。
+<期限>可能であれば、◯月◯日までにいただけると助かります。
+\`\`\`
+
+## 出力形式
+
+以下のJSON形式で出力してください：
+{
+  "task_type": "report" | "confirm" | "request",
+  "after": "添削後のテキスト（テンプレート形式）",
+  "structure": {
+    "conclusion": "結論",
+    "reasoning": "根拠（あれば）",
+    "action": "アクション（あれば）"
+  },
+  "changes": [
+    {
+      "type": "structure" | "simplify" | "clarify" | "tone" | "logic" | "add",
+      "description": "変更内容",
+      "reason": "変更理由"
+    }
+  ],
+  "tone": "formal" | "casual"
+}`;
+
+/**
+ * エージェントオプションを作成
+ * @param {string} systemPrompt - システムプロンプト
+ * @returns {object} Agent SDKオプション
+ */
+export function createAgentOptions(systemPrompt) {
+  return {
+    allowedTools: ["Read"],
+    permissionMode: "bypassPermissions",
+    systemPrompt,
+  };
+}
+
+/**
+ * エージェントエラーをユーザーフレンドリーなメッセージに変換
+ * @param {Error} error - エラーオブジェクト
+ * @returns {string} ユーザー向けエラーメッセージ
+ */
+export function formatAgentError(error) {
+  const message = error.message || String(error);
+
+  if (message.includes("Claude Code not found") || message.includes("not authenticated")) {
+    return "❌ Claude Codeが認証されていません。\n\nターミナルで `claude` を実行して認証してください。";
+  }
+
+  if (message.includes("timeout") || message.includes("ETIMEDOUT")) {
+    return "❌ 処理がタイムアウトしました。\n\n再試行してください。";
+  }
+
+  if (message.includes("rate limit") || message.includes("429")) {
+    return "❌ APIレート制限に達しました。\n\nしばらく待ってから再試行してください。";
+  }
+
+  return `❌ エージェント処理中にエラーが発生しました: ${message}`;
+}
+
+// エージェント実行のタイムアウト（ミリ秒）
+export const AGENT_TIMEOUT_MS = 30000;