@line-harness/mcp-server 0.2.2 → 0.4.0

package/src/tools/manage-tags.ts

@@ -0,0 +1,90 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { getClient } from "../client.js";
+
+export function registerManageTags(server: McpServer): void {
+  server.tool(
+    "manage_tags",
+    "Create tags, add tags to friends, or remove tags from friends. Supports batch operations on multiple friends.",
+    {
+      action: z.enum(["create", "add", "remove"]).describe("Action to perform"),
+      tagName: z
+        .string()
+        .optional()
+        .describe("Tag name (for 'create' action)"),
+      tagColor: z
+        .string()
+        .optional()
+        .describe("Tag color hex code (for 'create' action, e.g. '#FF0000')"),
+      tagId: z
+        .string()
+        .optional()
+        .describe("Tag ID (for 'add' or 'remove' actions)"),
+      friendIds: z
+        .array(z.string())
+        .optional()
+        .describe(
+          "Friend IDs to add/remove the tag from (for 'add' or 'remove' actions)",
+        ),
+    },
+    async ({ action, tagName, tagColor, tagId, friendIds }) => {
+      try {
+        const client = getClient();
+
+        if (action === "create") {
+          if (!tagName) throw new Error("tagName is required for create action");
+          const tag = await client.tags.create({
+            name: tagName,
+            color: tagColor,
+          });
+          return {
+            content: [
+              {
+                type: "text" as const,
+                text: JSON.stringify({ success: true, tag }, null, 2),
+              },
+            ],
+          };
+        }
+
+        if (!tagId)
+          throw new Error("tagId is required for add/remove actions");
+        if (!friendIds?.length)
+          throw new Error("friendIds is required for add/remove actions");
+
+        const results: Array<{ friendId: string; status: string }> = [];
+        for (const friendId of friendIds) {
+          if (action === "add") {
+            await client.friends.addTag(friendId, tagId);
+          } else {
+            await client.friends.removeTag(friendId, tagId);
+          }
+          results.push({ friendId, status: "ok" });
+        }
+
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: JSON.stringify({ success: true, results }, null, 2),
+            },
+          ],
+        };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: JSON.stringify(
+                { success: false, error: String(error) },
+                null,
+                2,
+              ),
+            },
+          ],
+          isError: true,
+        };
+      }
+    },
+  );
+}

package/src/tools/send-message.ts

@@ -0,0 +1,60 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { getClient } from "../client.js";
+
+export function registerSendMessage(server: McpServer): void {
+  server.tool(
+    "send_message",
+    "Send a text or flex message to a specific friend. Use messageType 'flex' for rich card layouts.",
+    {
+      friendId: z.string().describe("The friend's ID to send the message to"),
+      content: z
+        .string()
+        .describe(
+          "Message content. For text: plain string. For flex: JSON string of LINE Flex Message.",
+        ),
+      messageType: z
+        .enum(["text", "flex"])
+        .default("text")
+        .describe(
+          "Message type: 'text' for plain text, 'flex' for Flex Message JSON",
+        ),
+    },
+    async ({ friendId, content, messageType }) => {
+      try {
+        const client = getClient();
+        const result = await client.friends.sendMessage(
+          friendId,
+          content,
+          messageType,
+        );
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: JSON.stringify(
+                { success: true, messageId: result.messageId },
+                null,
+                2,
+              ),
+            },
+          ],
+        };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: JSON.stringify(
+                { success: false, error: String(error) },
+                null,
+                2,
+              ),
+            },
+          ],
+          isError: true,
+        };
+      }
+    },
+  );
+}

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022"],
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["node_modules", "dist"]
+}

package/tsup.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+  entry: ["src/index.ts"],
+  format: ["esm"],
+  target: "node20",
+  outDir: "dist",
+  clean: true,
+  banner: {
+    js: "#!/usr/bin/env node",
+  },
+});

package/README.md

@@ -1,63 +0,0 @@
-# @line-harness/mcp-server
-
-MCP Server for LINE Harness — operate LINE official accounts from Claude Code, Cursor, or any MCP-compatible AI tool via natural language.
-
-## Quick Setup
-
-Add to your MCP config (`claude_desktop_config.json` for Claude Code, `mcp.json` for Cursor):
-
-```json
-{
-  "mcpServers": {
-    "line-harness": {
-      "command": "npx",
-      "args": ["-y", "@line-harness/mcp-server"],
-      "env": {
-        "LINE_HARNESS_API_URL": "https://your-worker.your-subdomain.workers.dev",
-        "LINE_HARNESS_API_KEY": "your_api_key"
-      }
-    }
-  }
-}
-```
-
-Restart your AI tool. The 14 LINE Harness tools will appear automatically.
-
-## Available Tools
-
-| Tool | Description |
-|---|---|
-| `account_summary` | High-level overview: friend count, active scenarios, recent broadcasts, tags |
-| `list_friends` | List friends with optional tag filtering and pagination |
-| `get_friend_detail` | Detailed profile, tags, and metadata for a specific friend |
-| `send_message` | Send text or flex message to a specific friend |
-| `broadcast` | Send broadcast to all friends, a tag group, or a filtered segment |
-| `manage_tags` | Create tags, add/remove tags on friends (supports batch) |
-| `create_scenario` | Create a step-delivery scenario with delays and triggers |
-| `enroll_in_scenario` | Enroll a friend into a scenario manually |
-| `create_form` | Create a response-collection form with auto-tag on submit |
-| `get_form_submissions` | Retrieve all submissions for a form |
-| `create_tracked_link` | Create a click-tracking link with auto-tag on click |
-| `get_link_clicks` | Click analytics for a tracked link |
-| `create_rich_menu` | Create a LINE rich menu (persistent bottom menu) |
-| `list_crm_objects` | List scenarios, forms, tags, rich menus, tracked links, or broadcasts |
-
-## Environment Variables
-
-| Variable | Description |
-|---|---|
-| `LINE_HARNESS_API_URL` | URL of your deployed Cloudflare Worker (e.g. `https://my-worker.workers.dev`) |
-| `LINE_HARNESS_API_KEY` | API key set as `API_KEY` secret on your Worker |
-
-## Requirements
-
-- Node.js 20+
-- A running LINE Harness Worker ([deploy guide](https://github.com/Shudesu/line-harness-oss#quick-start))
-
-## Main Repository
-
-[github.com/Shudesu/line-harness-oss](https://github.com/Shudesu/line-harness-oss)
-
-## License
-
-MIT