whooing-mcp 0.1.0 → 0.2.0

package/README.md

@@ -1,5 +1,7 @@
 # whooing-mcp
 
+[![npm version](https://img.shields.io/npm/v/whooing-mcp.svg)](https://www.npmjs.com/package/whooing-mcp)
+
 MCP server for [Whooing (후잉)](https://whooing.com) personal finance — read-only queries for spending, transactions, balance sheets, and accounts.
 
 ## Setup
@@ -10,16 +12,7 @@ MCP server for [Whooing (후잉)](https://whooing.com) personal finance — read
 2. Note your `app_id`, `token`, and `signature`
 3. Find your `section_id` from the API or URL
 
-### 2. Install
-
-```bash
-git clone https://github.com/jmjeong/whooing-mcp.git
-cd whooing-mcp
-npm install
-npm run build
-```
-
-### 3. Configure Environment
+### 2. Configure Environment
 
 ```bash
 export WHOOING_APP_ID=3
@@ -35,13 +28,13 @@ Or create a `.env` file (see `.env.example`).
 ### stdio mode (Claude Code, Claude Desktop)
 
 ```bash
-node dist/cli.js
+npx whooing-mcp
 ```
 
 ### HTTP mode (daemon)
 
 ```bash
-node dist/cli.js --http --port 8182
+npx whooing-mcp --http --port 8182
 ```
 
 ### Claude Code config (`~/.mcp.json`)
@@ -50,8 +43,8 @@ node dist/cli.js --http --port 8182
 {
   "mcpServers": {
     "whooing": {
-      "command": "node",
-      "args": ["/path/to/whooing-mcp/dist/cli.js"],
+      "command": "npx",
+      "args": ["whooing-mcp"],
       "env": {
         "WHOOING_APP_ID": "3",
         "WHOOING_TOKEN": "...",
@@ -69,8 +62,8 @@ node dist/cli.js --http --port 8182
 {
   "mcpServers": {
     "whooing": {
-      "command": "node",
-      "args": ["/path/to/whooing-mcp/dist/cli.js"],
+      "command": "npx",
+      "args": ["whooing-mcp"],
       "env": {
         "WHOOING_APP_ID": "3",
         "WHOOING_TOKEN": "...",
@@ -108,8 +101,8 @@ Create `~/Library/LaunchAgents/com.whooing.mcp.plist`:
     <key>Label</key><string>com.whooing.mcp</string>
     <key>ProgramArguments</key>
     <array>
-        <string>/opt/homebrew/bin/node</string>
-        <string>/path/to/whooing-mcp/dist/cli.js</string>
+        <string>/opt/homebrew/bin/npx</string>
+        <string>whooing-mcp</string>
         <string>--http</string>
         <string>--port</string>
         <string>8182</string>
@@ -120,6 +113,7 @@ Create `~/Library/LaunchAgents/com.whooing.mcp.plist`:
         <key>WHOOING_TOKEN</key><string>YOUR_TOKEN</string>
         <key>WHOOING_SIGNATURE</key><string>YOUR_SIGNATURE</string>
         <key>WHOOING_SECTION_ID</key><string>YOUR_SECTION_ID</string>
+        <key>PATH</key><string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin</string>
     </dict>
     <key>KeepAlive</key><true/>
     <key>RunAtLoad</key><true/>
@@ -134,6 +128,16 @@ chmod 600 ~/Library/LaunchAgents/com.whooing.mcp.plist
 launchctl load ~/Library/LaunchAgents/com.whooing.mcp.plist
 ```
 
+## Development
+
+```bash
+git clone https://github.com/jmjeong/whooing-mcp.git
+cd whooing-mcp
+npm install
+npm run build
+node dist/cli.js
+```
+
 ## License
 
 MIT

package/dist/server.js

@@ -30,12 +30,12 @@ const dateRangeSchema = {
 export function createWhooingMcpServer(client) {
     const server = new McpServer({
         name: "whooing-mcp",
-        version: "0.1.0",
+        version: "0.2.0",
     }, {
         instructions: "Whooing (후잉) is a Korean personal finance tracking service. " +
-            "This server provides read-only access to financial data: " +
+            "This server provides access to financial data: " +
             "spending/income summaries (P&L), transaction lists, balance sheets, " +
-            "and account listings. " +
+            "and account listings, and can create new expense entries. " +
             "Dates use YYYYMMDD format. All amounts are in KRW (원). " +
             "If no dates are specified, the current month is used.",
     });
@@ -137,5 +137,81 @@ export function createWhooingMcpServer(client) {
         const text = formatSections(results);
         return { content: [{ type: "text", text }] };
     });
+    // whooing_add_entry — Create a new entry
+    server.registerTool("whooing_add_entry", {
+        description: "Create a new transaction entry in Whooing (e.g. expense, income). " +
+            "Use whooing_accounts first to look up account IDs.",
+        inputSchema: {
+            entry_date: z
+                .string()
+                .regex(/^\d{8}$/)
+                .describe("Transaction date in YYYYMMDD format"),
+            l_account_id: z
+                .string()
+                .describe("Left account ID (e.g. expense category like x11 for 식비)"),
+            r_account_id: z
+                .string()
+                .describe("Right account ID (e.g. payment method like x24 for 삼성카드)"),
+            item: z.string().describe("Item description (store name or item)"),
+            money: z.number().positive().describe("Amount in KRW"),
+            memo: z.string().optional().describe("Optional memo"),
+            section_id: z
+                .string()
+                .optional()
+                .describe("Section ID. Defaults to WHOOING_SECTION_ID env var."),
+        },
+        annotations: { readOnlyHint: false },
+    }, async (args) => {
+        const sectionId = args.section_id ?? client.defaultSectionId;
+        // Load accounts to resolve account types
+        await client.loadAccounts(sectionId);
+        const lInfo = client.getAccountInfo(args.l_account_id);
+        const rInfo = client.getAccountInfo(args.r_account_id);
+        if (!lInfo) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: Unknown left account ID "${args.l_account_id}". Use whooing_accounts to look up valid IDs.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (!rInfo) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: Unknown right account ID "${args.r_account_id}". Use whooing_accounts to look up valid IDs.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const body = {
+            section_id: sectionId,
+            entry_date: args.entry_date,
+            l_account: lInfo.type,
+            l_account_id: args.l_account_id,
+            r_account: rInfo.type,
+            r_account_id: args.r_account_id,
+            item: args.item,
+            money: String(args.money),
+        };
+        if (args.memo) {
+            body.memo = args.memo;
+        }
+        await client.apiPost("entries.json", body);
+        const formattedDate = `${args.entry_date.slice(0, 4)}-${args.entry_date.slice(4, 6)}-${args.entry_date.slice(6, 8)}`;
+        const text = `Entry created successfully.\n` +
+            `  Date: ${formattedDate}\n` +
+            `  Left: ${lInfo.name} (${lInfo.type})\n` +
+            `  Right: ${rInfo.name} (${rInfo.type})\n` +
+            `  Item: ${args.item}\n` +
+            `  Amount: ${args.money.toLocaleString()}원` +
+            (args.memo ? `\n  Memo: ${args.memo}` : "");
+        return { content: [{ type: "text", text }] };
+    });
     return server;
 }

package/dist/whooing-client.d.ts

@@ -15,6 +15,7 @@ export declare class WhooingClient {
     get defaultSectionId(): string;
     private getApiKey;
     apiGet(endpoint: string, params?: Record<string, string>): Promise<unknown>;
+    apiPost(endpoint: string, body: Record<string, string>): Promise<unknown>;
     loadAccounts(sectionId?: string): Promise<Map<string, AccountInfo>>;
     getAccountName(accountId: string): string;
     getAccountInfo(accountId: string): AccountInfo | undefined;

package/dist/whooing-client.js

@@ -34,6 +34,25 @@ export class WhooingClient {
         }
         return json.results;
     }
+    async apiPost(endpoint, body) {
+        const res = await fetch(`https://whooing.com/api/${endpoint}`, {
+            method: "POST",
+            headers: {
+                "X-API-KEY": this.getApiKey(),
+                "Content-Type": "application/x-www-form-urlencoded",
+            },
+            body: new URLSearchParams(body).toString(),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`Whooing API error ${res.status}: ${text}`);
+        }
+        const json = (await res.json());
+        if (json.code !== 200) {
+            throw new Error(`Whooing API error ${json.code}: ${json.message}`);
+        }
+        return json.results;
+    }
     async loadAccounts(sectionId) {
         const sid = sectionId || this.config.defaultSectionId;
         const results = (await this.apiGet("accounts.json", {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "whooing-mcp",
-  "version": "0.1.0",
-  "description": "MCP server for Whooing (후잉) personal finance — read-only queries for spending, transactions, budgets, and balance sheets",
+  "version": "0.2.0",
+  "description": "MCP server for Whooing (후잉) personal finance — queries and entry creation for spending, transactions, budgets, and balance sheets",
   "type": "module",
   "main": "./dist/server.js",
   "scripts": {