@rubyjobs-jp/tanebi-mcp-server 1.0.2

package/.github/workflows/publish.yml

@@ -0,0 +1,26 @@
+name: Publish to npm
+
+on:
+  push:
+    tags: ['v*']
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org
+
+      - run: npm ci
+
+      - run: npm run build
+
+      - run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/README.md

@@ -0,0 +1,82 @@
+# Tanebi MCP Server
+
+Tanebi API にアクセスするための [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) サーバー。
+Claude Code などの AI ツールから企画の一覧取得・詳細取得・新規作成が可能。
+
+## セットアップ
+
+```bash
+cd mcp-server
+npm install
+npm run build
+```
+
+## 環境変数
+
+| 変数名 | 必須 | 説明 |
+|--------|------|------|
+| `TANEBI_API_KEY` | Yes | Tanebi iOS アプリの設定画面から発行した API Key |
+| `TANEBI_API_BASE_URL` | No | API のベース URL（デフォルト: `http://localhost:3000`） |
+
+## 提供ツール
+
+### `list_ideas` - 企画一覧取得
+
+公開されている企画の一覧を取得する。
+
+| パラメータ | 型 | 必須 | デフォルト | 説明 |
+|-----------|------|------|-----------|------|
+| `page` | number | No | 1 | ページ番号 |
+| `per_page` | number | No | 20 | 1ページあたりの件数（最大100） |
+
+### `get_idea` - 企画詳細取得
+
+指定した企画の詳細情報（本文ライン・リアクション含む）を取得する。
+
+| パラメータ | 型 | 必須 | 説明 |
+|-----------|------|------|------|
+| `idea_id` | number | Yes | 企画の ID |
+
+### `create_idea` - 企画新規作成
+
+新しい企画を作成する。`content` は空行区切りで段落に分割され、`#` で始まる段落は見出しになる。
+
+| パラメータ | 型 | 必須 | デフォルト | 説明 |
+|-----------|------|------|-----------|------|
+| `title` | string | Yes | - | 企画タイトル |
+| `content` | string | No | - | 企画の本文 |
+| `visibility` | `"public"` \| `"private"` | No | `"public"` | 公開範囲 |
+
+## Claude Code での設定
+
+`~/.claude.json` または `.claude/settings.json` に追加:
+
+```json
+{
+  "mcpServers": {
+    "tanebi": {
+      "command": "node",
+      "args": ["/absolute/path/to/mcp-server/dist/index.js"],
+      "env": {
+        "TANEBI_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+開発時は `tsx` で直接実行も可能:
+
+```json
+{
+  "mcpServers": {
+    "tanebi": {
+      "command": "npx",
+      "args": ["tsx", "/absolute/path/to/mcp-server/src/index.ts"],
+      "env": {
+        "TANEBI_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+// --- Configuration ---
+const API_KEY = process.env.TANEBI_API_KEY;
+const API_BASE_URL = process.env.TANEBI_API_BASE_URL?.replace(/\/+$/, "") ||
+    "http://localhost:3000";
+if (!API_KEY) {
+    console.error("Error: TANEBI_API_KEY environment variable is required.\n" +
+        "Generate an API key from the Tanebi iOS app settings.");
+    process.exit(1);
+}
+async function apiRequest(path, options = {}) {
+    const { method = "GET", body } = options;
+    const headers = {
+        "X-API-Key": API_KEY,
+        Accept: "application/json",
+    };
+    if (body) {
+        headers["Content-Type"] = "application/json";
+    }
+    const response = await fetch(`${API_BASE_URL}${path}`, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : undefined,
+    });
+    if (!response.ok) {
+        const errorBody = await response.text();
+        throw new Error(`API request failed: ${response.status} ${response.statusText} - ${errorBody}`);
+    }
+    return response.json();
+}
+// --- Formatters ---
+function formatIdeaSummary(idea) {
+    return [
+        `[ID: ${idea.id}] ${idea.title}`,
+        `  Stage: ${idea.current_stage} | Visibility: ${idea.visibility}`,
+        `  Author: ${idea.user.display_name}`,
+        `  Reactions: ${idea.reactions_count} | Comments: ${idea.comments_count}`,
+        `  Created: ${idea.created_at}`,
+    ].join("\n");
+}
+function formatIdeaDetail(idea) {
+    const header = [
+        `# ${idea.title}`,
+        "",
+        `ID: ${idea.id}`,
+        `Stage: ${idea.current_stage} | Visibility: ${idea.visibility}`,
+        `Author: ${idea.user.display_name}`,
+        `Reactions: ${idea.reactions_count}`,
+        `Created: ${idea.created_at} | Updated: ${idea.updated_at}`,
+    ].join("\n");
+    const content = idea.lines.length > 0
+        ? "\n\n## Content\n\n" +
+            idea.lines
+                .sort((a, b) => a.position - b.position)
+                .map((line) => {
+                const prefix = line.line_type === "heading" ? "### " : "";
+                const commentTag = line.comments_count > 0 ? ` [${line.comments_count} comments]` : "";
+                return `${prefix}${line.content}${commentTag}`;
+            })
+                .join("\n\n")
+        : "\n\n(No content yet)";
+    const reactions = idea.reactions.length > 0
+        ? "\n\n## Reactions\n\n" +
+            idea.reactions
+                .map((r) => `- ${r.reaction_type} by ${r.user.display_name}`)
+                .join("\n")
+        : "";
+    return header + content + reactions;
+}
+// --- MCP Server ---
+const server = new McpServer({
+    name: "tanebi",
+    version: "1.0.0",
+});
+// Tool: list_ideas
+server.tool("list_ideas", "List ideas from Tanebi. Returns summaries with title, stage, author, and counts.", {
+    page: z
+        .number()
+        .int()
+        .positive()
+        .default(1)
+        .describe("Page number (default: 1)"),
+    per_page: z
+        .number()
+        .int()
+        .positive()
+        .max(100)
+        .default(20)
+        .describe("Items per page (default: 20, max: 100)"),
+}, async ({ page, per_page }) => {
+    const data = await apiRequest(`/api/v1/ideas?page=${page}&per_page=${per_page}`);
+    const summaries = data.ideas.map(formatIdeaSummary).join("\n\n");
+    const pagination = `\nPage ${data.meta.current_page} of ${data.meta.total_pages} (${data.meta.total_count} total ideas)`;
+    return {
+        content: [{ type: "text", text: summaries + "\n" + pagination }],
+    };
+});
+// Tool: get_idea
+server.tool("get_idea", "Get detailed information about a specific idea, including its content lines and reactions.", {
+    idea_id: z.number().int().positive().describe("The ID of the idea to retrieve"),
+}, async ({ idea_id }) => {
+    const data = await apiRequest(`/api/v1/ideas/${idea_id}`);
+    // The API may return the idea directly or wrapped in { idea: ... }
+    const idea = "idea" in data ? data.idea : data;
+    return {
+        content: [{ type: "text", text: formatIdeaDetail(idea) }],
+    };
+});
+// Tool: create_idea
+server.tool("create_idea", "Create a new idea on Tanebi. Content is split into paragraphs (separated by blank lines) and stored as lines.", {
+    title: z.string().min(1).describe("Title of the idea"),
+    content: z
+        .string()
+        .optional()
+        .describe("Content of the idea. Paragraphs are separated by blank lines. Lines starting with # become headings."),
+    visibility: z
+        .enum(["public", "private"])
+        .default("public")
+        .describe('Visibility: "public" or "private" (default: "public")'),
+}, async ({ title, content, visibility }) => {
+    const body = { title, visibility };
+    if (content) {
+        body.content = content;
+    }
+    const data = await apiRequest("/api/v1/ideas", { method: "POST", body });
+    const idea = "idea" in data ? data.idea : data;
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Idea created successfully!\n\n${formatIdeaDetail(idea)}`,
+            },
+        ],
+    };
+});
+// --- Start Server ---
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Failed to start MCP server:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@rubyjobs-jp/tanebi-mcp-server",
+  "version": "1.0.2",
+  "description": "MCP server for Tanebi API - list, get, and create ideas",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "tanebi-mcp-server": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,282 @@
+#!/usr/bin/env node
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+// --- Configuration ---
+
+const API_KEY = process.env.TANEBI_API_KEY;
+const API_BASE_URL =
+  process.env.TANEBI_API_BASE_URL?.replace(/\/+$/, "") ||
+  "http://localhost:3000";
+
+if (!API_KEY) {
+  console.error(
+    "Error: TANEBI_API_KEY environment variable is required.\n" +
+      "Generate an API key from the Tanebi iOS app settings."
+  );
+  process.exit(1);
+}
+
+// --- API Client ---
+
+interface ApiRequestOptions {
+  method?: string;
+  body?: Record<string, unknown>;
+}
+
+async function apiRequest<T>(
+  path: string,
+  options: ApiRequestOptions = {}
+): Promise<T> {
+  const { method = "GET", body } = options;
+
+  const headers: Record<string, string> = {
+    "X-API-Key": API_KEY!,
+    Accept: "application/json",
+  };
+
+  if (body) {
+    headers["Content-Type"] = "application/json";
+  }
+
+  const response = await fetch(`${API_BASE_URL}${path}`, {
+    method,
+    headers,
+    body: body ? JSON.stringify(body) : undefined,
+  });
+
+  if (!response.ok) {
+    const errorBody = await response.text();
+    throw new Error(
+      `API request failed: ${response.status} ${response.statusText} - ${errorBody}`
+    );
+  }
+
+  return response.json() as Promise<T>;
+}
+
+// --- Response Types ---
+
+interface SimplifiedUser {
+  id: number;
+  display_name: string;
+  avatar_path: string | null;
+}
+
+interface IdeaSummary {
+  id: number;
+  title: string;
+  visibility: string;
+  current_stage: string;
+  reactions_count: number;
+  comments_count: number;
+  is_bookmarked: boolean;
+  created_at: string;
+  updated_at: string;
+  user: SimplifiedUser;
+}
+
+interface IdeaLine {
+  id: number;
+  line_type: string;
+  content: string;
+  position: number;
+  comments_count: number;
+  created_at: string;
+  updated_at: string;
+}
+
+interface Reaction {
+  id: number;
+  reaction_type: string;
+  created_at: string;
+  user: SimplifiedUser;
+}
+
+interface IdeaDetail {
+  id: number;
+  title: string;
+  visibility: string;
+  current_stage: string;
+  reactions_count: number;
+  is_bookmarked: boolean;
+  created_at: string;
+  updated_at: string;
+  user: SimplifiedUser;
+  lines: IdeaLine[];
+  reactions: Reaction[];
+}
+
+interface PaginationMeta {
+  current_page: number;
+  total_pages: number;
+  total_count: number;
+}
+
+interface IdeasListResponse {
+  ideas: IdeaSummary[];
+  meta: PaginationMeta;
+}
+
+// --- Formatters ---
+
+function formatIdeaSummary(idea: IdeaSummary): string {
+  return [
+    `[ID: ${idea.id}] ${idea.title}`,
+    `  Stage: ${idea.current_stage} | Visibility: ${idea.visibility}`,
+    `  Author: ${idea.user.display_name}`,
+    `  Reactions: ${idea.reactions_count} | Comments: ${idea.comments_count}`,
+    `  Created: ${idea.created_at}`,
+  ].join("\n");
+}
+
+function formatIdeaDetail(idea: IdeaDetail): string {
+  const header = [
+    `# ${idea.title}`,
+    "",
+    `ID: ${idea.id}`,
+    `Stage: ${idea.current_stage} | Visibility: ${idea.visibility}`,
+    `Author: ${idea.user.display_name}`,
+    `Reactions: ${idea.reactions_count}`,
+    `Created: ${idea.created_at} | Updated: ${idea.updated_at}`,
+  ].join("\n");
+
+  const content =
+    idea.lines.length > 0
+      ? "\n\n## Content\n\n" +
+        idea.lines
+          .sort((a, b) => a.position - b.position)
+          .map((line) => {
+            const prefix = line.line_type === "heading" ? "### " : "";
+            const commentTag = line.comments_count > 0 ? ` [${line.comments_count} comments]` : "";
+            return `${prefix}${line.content}${commentTag}`;
+          })
+          .join("\n\n")
+      : "\n\n(No content yet)";
+
+  const reactions =
+    idea.reactions.length > 0
+      ? "\n\n## Reactions\n\n" +
+        idea.reactions
+          .map((r) => `- ${r.reaction_type} by ${r.user.display_name}`)
+          .join("\n")
+      : "";
+
+  return header + content + reactions;
+}
+
+// --- MCP Server ---
+
+const server = new McpServer({
+  name: "tanebi",
+  version: "1.0.0",
+});
+
+// Tool: list_ideas
+server.tool(
+  "list_ideas",
+  "List ideas from Tanebi. Returns summaries with title, stage, author, and counts.",
+  {
+    page: z
+      .number()
+      .int()
+      .positive()
+      .default(1)
+      .describe("Page number (default: 1)"),
+    per_page: z
+      .number()
+      .int()
+      .positive()
+      .max(100)
+      .default(20)
+      .describe("Items per page (default: 20, max: 100)"),
+  },
+  async ({ page, per_page }) => {
+    const data = await apiRequest<IdeasListResponse>(
+      `/api/v1/ideas?page=${page}&per_page=${per_page}`
+    );
+
+    const summaries = data.ideas.map(formatIdeaSummary).join("\n\n");
+    const pagination = `\nPage ${data.meta.current_page} of ${data.meta.total_pages} (${data.meta.total_count} total ideas)`;
+
+    return {
+      content: [{ type: "text" as const, text: summaries + "\n" + pagination }],
+    };
+  }
+);
+
+// Tool: get_idea
+server.tool(
+  "get_idea",
+  "Get detailed information about a specific idea, including its content lines and reactions.",
+  {
+    idea_id: z.number().int().positive().describe("The ID of the idea to retrieve"),
+  },
+  async ({ idea_id }) => {
+    const data = await apiRequest<{ idea: IdeaDetail }>(
+      `/api/v1/ideas/${idea_id}`
+    );
+
+    // The API may return the idea directly or wrapped in { idea: ... }
+    const idea = "idea" in data ? data.idea : (data as unknown as IdeaDetail);
+
+    return {
+      content: [{ type: "text" as const, text: formatIdeaDetail(idea) }],
+    };
+  }
+);
+
+// Tool: create_idea
+server.tool(
+  "create_idea",
+  "Create a new idea on Tanebi. Content is split into paragraphs (separated by blank lines) and stored as lines.",
+  {
+    title: z.string().min(1).describe("Title of the idea"),
+    content: z
+      .string()
+      .optional()
+      .describe(
+        "Content of the idea. Paragraphs are separated by blank lines. Lines starting with # become headings."
+      ),
+    visibility: z
+      .enum(["public", "private"])
+      .default("public")
+      .describe('Visibility: "public" or "private" (default: "public")'),
+  },
+  async ({ title, content, visibility }) => {
+    const body: Record<string, unknown> = { title, visibility };
+    if (content) {
+      body.content = content;
+    }
+
+    const data = await apiRequest<{ idea: IdeaDetail } | IdeaDetail>(
+      "/api/v1/ideas",
+      { method: "POST", body }
+    );
+
+    const idea = "idea" in data ? data.idea : data;
+
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: `Idea created successfully!\n\n${formatIdeaDetail(idea)}`,
+        },
+      ],
+    };
+  }
+);
+
+// --- Start Server ---
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main().catch((error) => {
+  console.error("Failed to start MCP server:", error);
+  process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}