@xferops/forge-mcp 2.0.0

package/.github/workflows/release.yml

@@ -0,0 +1,50 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Extract version from tag
+        id: version
+        run: echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
+
+      - name: Publish to npm
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Install ClawHub CLI
+        run: npm install -g clawhub
+
+      - name: Publish skill to ClawHub
+        run: |
+          clawhub login --token "$CLAWHUB_TOKEN" --no-browser
+          clawhub publish ./skill \
+            --slug xferops-forge \
+            --name "XferOps Forge" \
+            --version ${{ steps.version.outputs.VERSION }} \
+            --changelog "Release ${{ steps.version.outputs.VERSION }}"
+        env:
+          CLAWHUB_TOKEN: ${{ secrets.CLAWHUB_TOKEN }}

package/README.md

@@ -0,0 +1,225 @@
+# ⚒️ Forge MCP Server
+
+MCP (Model Context Protocol) server for [Forge](https://forge.xferops.dev) — XferOps' project management system.
+
+Works with **Claude Code**, **OpenAI Codex**, **OpenClaw/mcporter**, and any MCP-compatible consumer.
+
+> **Migrated from `@xferops/flower-mcp`** — see [Migration Guide](#migration-guide) below.
+
+## Quick Start
+
+### 1. Get Your API Token
+
+1. Go to [forge.xferops.dev/settings](https://forge.xferops.dev/settings)
+2. Click **New Token** in the API Tokens section
+3. Give it a descriptive name and click **Create Token**
+4. Copy the token (it won't be shown again!)
+
+### 2. Install
+
+```bash
+npm install -g @xferops/forge-mcp
+```
+
+Or use with npx (no install needed):
+```bash
+npx @xferops/forge-mcp
+```
+
+### 3. Configure Your MCP Consumer
+
+See setup instructions below for your specific tool.
+
+---
+
+## Setup Instructions
+
+### Claude Code (`claude_desktop_config.json`)
+
+Add to `~/.config/claude/claude_desktop_config.json` (macOS/Linux) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "forge": {
+      "command": "npx",
+      "args": ["-y", "@xferops/forge-mcp"],
+      "env": {
+        "FORGE_URL": "https://forge.xferops.dev",
+        "FORGE_TOKEN": "your-api-token-here"
+      }
+    }
+  }
+}
+```
+
+### OpenClaw / mcporter
+
+Add to `~/.mcporter/mcporter.json`:
+
+```json
+{
+  "mcpServers": {
+    "forge": {
+      "command": "npx",
+      "args": ["-y", "@xferops/forge-mcp"],
+      "env": {
+        "FORGE_URL": "https://forge.xferops.dev",
+        "FORGE_TOKEN": "your-api-token-here"
+      }
+    }
+  }
+}
+```
+
+Then use with mcporter:
+```bash
+mcporter call forge.forge_list_teams
+mcporter call forge.forge_get_project projectId=abc123
+mcporter call forge.forge_search_tasks query="ADM-5"
+```
+
+### Environment Variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `FORGE_TOKEN` | Yes | — | Your API token from forge.xferops.dev/settings |
+| `FORGE_URL` | No | `https://forge.xferops.dev` | API base URL |
+| `FLOWER_TOKEN` | No | — | Legacy alias for `FORGE_TOKEN` (deprecated) |
+| `FLOWER_URL` | No | — | Legacy alias for `FORGE_URL` (deprecated) |
+| `KANBAN_TOKEN` | No | — | Legacy alias for `FORGE_TOKEN` (deprecated) |
+| `KANBAN_URL` | No | — | Legacy alias for `FORGE_URL` (deprecated) |
+
+---
+
+## Available Tools (26)
+
+### Health
+| Tool | Description |
+|------|-------------|
+| `forge_health_check` | Check API connectivity and configured URL |
+
+### Teams
+| Tool | Description |
+|------|-------------|
+| `forge_list_teams` | List all teams you belong to |
+| `forge_create_team` | Create a new team |
+| `forge_list_team_members` | List team members (get user IDs for assignment) |
+| `forge_add_team_member` | Add a user to a team by email |
+
+### Projects
+| Tool | Description |
+|------|-------------|
+| `forge_list_projects` | List projects in a team |
+| `forge_get_project` | Get project with all columns and tasks |
+| `forge_create_project` | Create a new project |
+| `forge_update_project` | Update project name/prefix |
+| `forge_delete_project` | Delete a project |
+
+### Columns
+| Tool | Description |
+|------|-------------|
+| `forge_create_column` | Create a column (e.g., "Backlog", "Done") |
+| `forge_update_column` | Rename a column |
+| `forge_delete_column` | Delete a column (optionally move tasks) |
+| `forge_reorder_columns` | Reorder columns |
+
+### Tasks
+| Tool | Description |
+|------|-------------|
+| `forge_get_task` | Get a single task by ID |
+| `forge_list_tasks` | List all tasks in a project |
+| `forge_search_tasks` | Search tasks by title/description/ticket ID (e.g., "ADM-5") |
+| `forge_create_task` | Create a new task |
+| `forge_update_task` | Update task or move to different column |
+| `forge_move_task` | Move task to a different column (convenience wrapper) |
+| `forge_delete_task` | Delete a task |
+| `forge_reorder_task` | Move task to specific position within a column |
+
+### Comments
+| Tool | Description |
+|------|-------------|
+| `forge_list_comments` | List comments on a task |
+| `forge_create_comment` | Add a comment |
+| `forge_update_comment` | Edit your comment |
+| `forge_delete_comment` | Delete your comment |
+
+---
+
+## Migration Guide
+
+Migrating from `@xferops/flower-mcp`?
+
+### 1. Update your MCP config
+
+```diff
+- "command": "npx",
+- "args": ["-y", "@xferops/flower-mcp"],
+- "env": {
+-   "FLOWER_URL": "https://flower.xferops.dev",
+-   "FLOWER_TOKEN": "your-token"
+- }
++ "command": "npx",
++ "args": ["-y", "@xferops/forge-mcp"],
++ "env": {
++   "FORGE_URL": "https://forge.xferops.dev",
++   "FORGE_TOKEN": "your-token"
++ }
+```
+
+### 2. Update tool calls
+
+All tools are renamed from `flower_*` to `forge_*`:
+
+```diff
+- flower_search_tasks query="ADM-5"
++ forge_search_tasks query="ADM-5"
+```
+
+**Note:** `FLOWER_URL` / `FLOWER_TOKEN` env vars are still accepted as fallbacks during the transition period.
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/XferOps/forge-mcp.git
+cd forge-mcp
+npm install
+npm run build
+
+# Run locally
+FORGE_TOKEN=your-token node dist/index.js
+```
+
+---
+
+## OpenClaw Skill
+
+Install via ClawHub:
+
+```bash
+npx clawhub@latest install xferops-forge
+```
+
+---
+
+## Versioning
+
+| Tag | Version |
+|-----|---------|
+| `v2.x` | Forge MCP (`@xferops/forge-mcp`) |
+| `v1.x` | Flower MCP (`@xferops/flower-mcp`) — deprecated |
+
+Tag and release:
+```bash
+git tag v2.x.x && git push --tags
+```
+
+CI will publish to npm and ClawHub automatically.
+
+---
+
+## License
+
+MIT © [XferOps](https://xferops.com)

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Forge MCP Server
+ *
+ * MCP (Model Context Protocol) server for interacting with the Forge API.
+ * Forge is XferOps' project management system (formerly Flower/Kanban).
+ *
+ * Works with: Claude Code, OpenAI Codex, OpenClaw/mcporter, and any MCP consumer.
+ *
+ * @see https://forge.xferops.dev/docs for API documentation
+ */
+export {};