@mac-claw/mcp 1.1.0

package/README.md

@@ -0,0 +1,268 @@
+# @macclaw/mcp
+
+MCP server for **Mac Claw** - AI-powered Mac mini / Mac Studio CtoC marketplace. 47 tools for items, market analysis, checkout, watches, inspections, notifications, and more.
+
+## What is Mac Claw?
+
+Mac Claw (macclaw.jp) is a specialized CtoC marketplace for Mac mini and Mac Studio, focused on AI/ML engineers. AI agents can analyze market prices, manage listings, handle transactions, set up watch alerts, and perform remote inspections — all through MCP tools.
+
+## Installation
+
+### For Claude Code
+
+```bash
+claude mcp add macclaw -- npx -y @macclaw/mcp
+```
+
+Then set the environment variable:
+```bash
+export MACCLAW_API_KEY="mc_your_key_here"
+```
+
+Or add to your MCP settings file (`~/.claude/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "macclaw": {
+      "command": "npx",
+      "args": ["-y", "@macclaw/mcp"],
+      "env": {
+        "MACCLAW_API_KEY": "mc_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### For Cursor
+
+Add to `.cursor/mcp.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "macclaw": {
+      "command": "npx",
+      "args": ["-y", "@macclaw/mcp"],
+      "env": {
+        "MACCLAW_API_KEY": "mc_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### HTTP Mode
+
+Start the server in HTTP mode:
+
+```bash
+MACCLAW_API_KEY=mc_xxx MACCLAW_TRANSPORT=http MACCLAW_PORT=3006 npx @macclaw/mcp
+```
+
+Then connect to `http://localhost:3006/mcp`
+
+## Getting an API Key
+
+1. Visit [https://macclaw.jp](https://macclaw.jp)
+2. Sign up with magic link authentication
+3. Go to **My Page** > **API Keys** (`/mypage/api-keys/`)
+4. Create a new API key
+5. Copy the generated key (starts with `mc_`, 52 characters)
+
+**Limits:** Up to 10 API keys per user. Rate limits: 200 reads/min, 30 writes/min per key.
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `MACCLAW_API_KEY` | (required) | Your API key (starts with `mc_`) |
+| `MACCLAW_BASE_URL` | `https://macclaw.jp` | API base URL |
+| `MACCLAW_TRANSPORT` | `stdio` | Transport mode: `stdio` (local) or `http` (server) |
+| `MACCLAW_PORT` | `3006` | HTTP server port (only used when `MACCLAW_TRANSPORT=http`) |
+
+## Available Tools (47 total)
+
+### Items (7 tools)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `items_list` | List items with filters, sorting, pagination | read |
+| `items_get` | Get item details (images, comments) | read |
+| `items_search` | Full-text search items | read |
+| `items_create` | Create a new listing | write |
+| `items_update` | Update a listing | write |
+| `items_publish` | Publish a draft listing | write |
+| `items_cancel` | Cancel a listing | write |
+
+### Market Analysis (5 tools)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `market_price_range` | Price range by chip/memory | read |
+| `market_recent_sales` | Recent completed sales data | read |
+| `market_price_suggest` | AI-suggested market price | read |
+| `market_retail_compare` | Compare with retail prices | read |
+| `market_demand_score` | Demand score (0-100) | read |
+
+### Checkout (3 tools)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `checkout_create` | Generate Stripe Checkout URL | write |
+| `payment_status` | Check payment status | read |
+| `payment_refund` | Request a refund | write |
+
+### Transactions (3 tools)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `transactions_list` | List transactions | read |
+| `transactions_get` | Get transaction details | read |
+| `transactions_ship` | Register shipment | write |
+
+### Messages (2 tools)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `messages_list` | List messages in a transaction | read |
+| `messages_send` | Send a message | write |
+
+### Users (3 tools)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `users_me` | Get your profile + stats | read |
+| `users_get` | Get another user's info | read |
+| `users_update_profile` | Update your profile | write |
+
+### Social (3 tools)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `social_like` | Toggle like on an item | write |
+| `social_comment` | Post a comment | write |
+| `social_follow` | Toggle follow on a user | write |
+
+### Reviews (2 tools)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `reviews_list` | List reviews for a user | read |
+| `reviews_post` | Post a review | write |
+
+### Watch Alerts (5 tools)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `watch_create` | Create a watch alert (chip, memory, price range) | write |
+| `watch_list` | List your watch alerts | read |
+| `watch_delete` | Delete a watch alert | write |
+| `watch_check` | Run all watch condition checks | write |
+| `watch_matches` | Get watch match history | read |
+
+### Inspections (2 tools)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `inspect_submit` | Submit hardware inspection data | write |
+| `inspect_get` | Get inspection data for an item | read |
+
+### Notifications (3 tools)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `notifications_broadcast` | Broadcast to watch users on new listing | write |
+| `notifications_list` | List your notifications | read |
+| `notifications_read` | Mark notification as read | write |
+
+### Agent (1 tool)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `agent_upgrade_plan` | AI upgrade simulation (trade-in value + recommendation) | read |
+
+### Stripe Connect (2 tools)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `connect_status` | Check Stripe Connect onboarding status | read |
+| `connect_balance` | Check Connect balance | read |
+
+### Specs (3 tools)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `specs_chip_list` | List Apple Silicon chips | read |
+| `specs_chip_detail` | Get chip configurations (memory, storage options) | read |
+| `specs_device_models` | Get device model cascade | read |
+
+### Stats (1 tool)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `stats_dashboard` | Platform dashboard statistics | read |
+
+### Health (1 tool)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `health` | Health check (no auth required) | read |
+
+## Use Cases
+
+### 1. Market Research
+
+```javascript
+// Check market prices for M4 Pro Mac Mini
+market_price_range({ chip: "M4 Pro", memory: 48 })
+market_demand_score({ chip: "M4 Pro", device_type: "mac_mini" })
+market_recent_sales({ chip: "M4 Pro", limit: 10 })
+```
+
+### 2. Smart Listing
+
+```javascript
+// Get price suggestion and create listing
+const suggestion = market_price_suggest({ chip: "M2 Ultra", memory: 192 })
+items_create({
+  title: "Mac Studio M2 Ultra 192GB",
+  price: suggestion.suggested_price,
+  chip: "M2 Ultra",
+  memory: 192,
+  storage: 2000
+})
+```
+
+### 3. Watch Alerts
+
+```javascript
+// Set up alert for M4 Pro under 200,000 yen
+watch_create({
+  chip: "M4 Pro",
+  max_price: 200000,
+  device_type: "mac_mini"
+})
+// Check for matches
+watch_check({})
+```
+
+## Error Handling
+
+| Code | Description |
+|------|-------------|
+| `401` | Invalid API key |
+| `403` | Permission denied |
+| `404` | Resource not found |
+| `422` | Validation error |
+| `429` | Rate limit exceeded |
+
+## Support
+
+- **Website:** [https://macclaw.jp](https://macclaw.jp)
+- **Agent Docs:** [https://macclaw.jp/agent/](https://macclaw.jp/agent/)
+
+## License
+
+MIT License - Copyright (c) 2026 ASI Productions

package/lib/api-client.js

@@ -0,0 +1,168 @@
+/**
+ * Mac Claw REST API Client
+ * AI Mac Marketplace
+ */
+
+export class MacClawApiClient {
+    constructor(apiKey, baseUrl = 'https://macclaw.jp') {
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl.replace(/\/$/, '');
+    }
+
+    async request(action, params = {}) {
+        const url = `${this.baseUrl}/api/mcp.php`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${this.apiKey}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ action, params }),
+        });
+
+        const json = await response.json();
+        if (!response.ok || !json.success) {
+            throw new Error(json.message || `API error: ${response.status}`);
+        }
+        return json.data;
+    }
+
+    // ==========================================
+    // 商品 (7)
+    // ==========================================
+
+    async itemsList(params) { return this.request('items.list', params); }
+    async itemsGet(id) { return this.request('items.get', { id }); }
+    async itemsSearch(query, params = {}) { return this.request('items.search', { query, ...params }); }
+    async itemsCreate(data) { return this.request('items.create', data); }
+    async itemsUpdate(id, data) { return this.request('items.update', { id, ...data }); }
+    async itemsPublish(id) { return this.request('items.publish', { id }); }
+    async itemsCancel(id) { return this.request('items.cancel', { id }); }
+
+    // ==========================================
+    // 相場 (5)
+    // ==========================================
+
+    async marketPriceRange(params = {}) { return this.request('market.price_range', params); }
+    async marketRecentSales(params = {}) { return this.request('market.recent_sales', params); }
+    async marketPriceSuggest(params) { return this.request('market.price_suggest', params); }
+    async marketRetailCompare(params) { return this.request('market.retail_compare', params); }
+    async marketDemandScore(itemId) { return this.request('market.demand_score', { item_id: itemId }); }
+
+    // ==========================================
+    // 決済 (1)
+    // ==========================================
+
+    async checkoutCreate(itemId) { return this.request('checkout.create', { item_id: itemId }); }
+
+    // ==========================================
+    // 取引 (3)
+    // ==========================================
+
+    async transactionsList(params = {}) { return this.request('transactions.list', params); }
+    async transactionsGet(id) { return this.request('transactions.get', { id }); }
+    async transactionsShip(id, trackingNumber) { return this.request('transactions.ship', { id, tracking_number: trackingNumber }); }
+
+    // ==========================================
+    // メッセージ (2)
+    // ==========================================
+
+    async messagesList(transactionId) { return this.request('messages.list', { transaction_id: transactionId }); }
+    async messagesSend(transactionId, body) { return this.request('messages.send', { transaction_id: transactionId, body }); }
+
+    // ==========================================
+    // ユーザー (3)
+    // ==========================================
+
+    async usersMe() { return this.request('users.me'); }
+    async usersGet(id) { return this.request('users.get', { id }); }
+    async usersUpdateProfile(data) { return this.request('users.update_profile', data); }
+
+    // ==========================================
+    // ソーシャル (3)
+    // ==========================================
+
+    async socialLike(itemId) { return this.request('social.like', { item_id: itemId }); }
+    async socialComment(itemId, body) { return this.request('social.comment', { item_id: itemId, body }); }
+    async socialFollow(userId) { return this.request('social.follow', { user_id: userId }); }
+
+    // ==========================================
+    // レビュー (2)
+    // ==========================================
+
+    async reviewsList(params = {}) { return this.request('reviews.list', params); }
+    async reviewsPost(transactionId, rating, comment) { return this.request('reviews.post', { transaction_id: transactionId, rating, comment }); }
+
+    // ==========================================
+    // ウォッチ (5)
+    // ==========================================
+
+    async watchCreate(data) { return this.request('watch.create', data); }
+    async watchList() { return this.request('watch.list'); }
+    async watchDelete(id) { return this.request('watch.delete', { id }); }
+    async watchCheck() { return this.request('watch.check'); }
+    async watchMatches(params = {}) { return this.request('watch.matches', params); }
+
+    // ==========================================
+    // 検品 (2)
+    // ==========================================
+
+    async inspectSubmit(data) { return this.request('inspect.submit', data); }
+    async inspectGet(itemId) { return this.request('inspect.get', { item_id: itemId }); }
+
+    // ==========================================
+    // 通知 (3)
+    // ==========================================
+
+    async notificationsBroadcast(itemId) { return this.request('notifications.broadcast', { item_id: itemId }); }
+    async notificationsList(params = {}) { return this.request('notifications.list', params); }
+    async notificationsRead(params = {}) { return this.request('notifications.read', params); }
+
+    // ==========================================
+    // エージェント (1)
+    // ==========================================
+
+    async agentUpgradePlan(params) { return this.request('agent.upgrade_plan', params); }
+
+    // ==========================================
+    // 決済追加 (2)
+    // ==========================================
+
+    async paymentStatus(transactionId) { return this.request('payment.status', { transaction_id: transactionId }); }
+    async paymentRefund(transactionId, reason) { return this.request('payment.refund', { transaction_id: transactionId, reason }); }
+
+    // ==========================================
+    // Connect (2)
+    // ==========================================
+
+    async connectStatus() { return this.request('connect.status'); }
+    async connectBalance() { return this.request('connect.balance'); }
+
+    // ==========================================
+    // スペック (3)
+    // ==========================================
+
+    async specsChipList() { return this.request('specs.chip_list'); }
+    async specsChipDetail(chip) { return this.request('specs.chip_detail', { chip }); }
+    async specsDeviceModels() { return this.request('specs.device_models'); }
+
+    // ==========================================
+    // 統計 (1)
+    // ==========================================
+
+    async statsDashboard() { return this.request('stats.dashboard'); }
+
+    // ==========================================
+    // ヘルス (認証不要)
+    // ==========================================
+
+    async health() {
+        const url = `${this.baseUrl}/api/mcp.php`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ action: 'health' }),
+        });
+        return response.json();
+    }
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@mac-claw/mcp",
+  "version": "1.1.0",
+  "description": "MCP Server for Mac Claw - AI Mac Marketplace. 47 tools for items, market analysis, checkout, watches, inspections, notifications, and more.",
+  "main": "server.js",
+  "type": "module",
+  "bin": {
+    "macclaw-mcp": "server.js"
+  },
+  "scripts": {
+    "start": "node server.js",
+    "start:http": "MACCLAW_TRANSPORT=http node server.js"
+  },
+  "keywords": ["mcp", "macclaw", "mac", "marketplace", "ai", "claude-code"],
+  "files": ["server.js", "lib/**/*.js", "README.md"],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/asi-productions/mothership"
+  },
+  "homepage": "https://macclaw.jp/agent/",
+  "bugs": {
+    "url": "https://github.com/asi-productions/mothership/issues"
+  },
+  "author": "ASI Productions",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  }
+}