@bridge_gpt/mcp-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bridge GPT
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,178 @@
+# @bridge_gpt/mcp-server
+
+MCP server for [Bridge API](https://bridgegpt-api.com) — exposes Jira integration endpoints as MCP tools for AI coding agents. Works with Claude Code, VS Code/Copilot, Cursor, Windsurf, and OpenAI Codex.
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `BAPI_BASE_URL` | Yes | `http://localhost:8000` | Bridge API base URL (production: `https://bridgegpt-api.com`) |
+| `BAPI_REPO_NAME` | Yes | _(none)_ | Jira project/repository identifier configured in Bridge API |
+| `BAPI_API_KEY` | Yes | _(none)_ | API key obtained from the Bridge API setup UI |
+| `BAPI_DOCS_DIR` | No | `docs/tmp` | Local directory for saving plans, critiques, and research reports |
+
+## Configuration
+
+### Claude Code (CLI)
+
+```bash
+claude mcp add bridge-api -- npx -y @bridge_gpt/mcp-server \
+  --env BAPI_BASE_URL=https://bridgegpt-api.com \
+  --env BAPI_REPO_NAME=your-repo \
+  --env BAPI_API_KEY=your-api-key \
+  --env BAPI_DOCS_DIR=docs/tmp
+```
+
+### Claude Code (.mcp.json)
+
+```json
+{
+  "mcpServers": {
+    "bridge-api": {
+      "command": "npx",
+      "args": ["-y", "@bridge_gpt/mcp-server"],
+      "env": {
+        "BAPI_BASE_URL": "https://bridgegpt-api.com",
+        "BAPI_REPO_NAME": "your-repo",
+        "BAPI_API_KEY": "your-api-key",
+        "BAPI_DOCS_DIR": "docs/tmp"
+      }
+    }
+  }
+}
+```
+
+### VS Code / Copilot (.vscode/mcp.json)
+
+```json
+{
+  "servers": {
+    "bridge-api": {
+      "command": "npx",
+      "args": ["-y", "@bridge_gpt/mcp-server"],
+      "env": {
+        "BAPI_BASE_URL": "https://bridgegpt-api.com",
+        "BAPI_REPO_NAME": "your-repo",
+        "BAPI_API_KEY": "your-api-key",
+        "BAPI_DOCS_DIR": "docs/tmp"
+      }
+    }
+  }
+}
+```
+
+### Cursor (~/.cursor/config/mcp.json)
+
+```json
+{
+  "mcpServers": {
+    "bridge-api": {
+      "command": "npx",
+      "args": ["-y", "@bridge_gpt/mcp-server"],
+      "env": {
+        "BAPI_BASE_URL": "https://bridgegpt-api.com",
+        "BAPI_REPO_NAME": "your-repo",
+        "BAPI_API_KEY": "your-api-key",
+        "BAPI_DOCS_DIR": "docs/tmp"
+      }
+    }
+  }
+}
+```
+
+### Windsurf (~/.codeium/windsurf/mcp_config.json)
+
+```json
+{
+  "mcpServers": {
+    "bridge-api": {
+      "command": "npx",
+      "args": ["-y", "@bridge_gpt/mcp-server"],
+      "env": {
+        "BAPI_BASE_URL": "https://bridgegpt-api.com",
+        "BAPI_REPO_NAME": "your-repo",
+        "BAPI_API_KEY": "your-api-key",
+        "BAPI_DOCS_DIR": "docs/tmp"
+      }
+    }
+  }
+}
+```
+
+### OpenAI Codex (~/.codex/config.toml)
+
+```toml
+[mcp_servers.bridge-api]
+command = "npx"
+args = ["-y", "@bridge_gpt/mcp-server"]
+
+[mcp_servers.bridge-api.env]
+BAPI_BASE_URL = "https://bridgegpt-api.com"
+BAPI_REPO_NAME = "your-repo"
+BAPI_API_KEY = "your-api-key"
+BAPI_DOCS_DIR = "docs/tmp"
+```
+
+## Available Tools
+
+| Tool | Description |
+|---|---|
+| `ping` | Health check — verify connectivity and API key |
+| `get_project_standards` | Retrieve configured coding standards |
+| `get_tickets` | Search and list Jira tickets |
+| `get_ticket` | Get full details for a single ticket |
+| `create_ticket` | Create a new Jira ticket |
+| `add_comment` | Add a comment to a ticket |
+| `update_ticket_description` | Replace a ticket's description |
+| `upload_attachment` | Upload a file as an attachment to a Jira ticket |
+| `request_plan_generation` | Generate an AI implementation plan (async) |
+| `get_plan` | Retrieve a generated implementation plan |
+| `request_architecture` | Generate an AI architecture plan (async) |
+| `get_architecture` | Retrieve a generated architecture plan |
+| `request_clarifying_questions` | Generate clarifying questions for a ticket (async) |
+| `get_clarifying_questions` | Retrieve generated clarifying questions |
+| `request_ticket_critique` | Generate a ticket quality critique (async) |
+| `get_ticket_critique` | Retrieve a generated ticket critique |
+| `request_reimplement_context` | Request reimplementation context (async) |
+| `get_reimplement_context` | Retrieve reimplementation context |
+| `request_deep_research` | Run deep research on a query (async) |
+| `get_deep_research` | Retrieve deep research results |
+| `parse_repository` | Parse and index a repository (async) |
+| `get_parse_status` | Check repository parse status |
+| `regenerate_directory_map` | Regenerate the repository directory map |
+| `track_ticket` | Register a ticket for lifecycle tracking |
+| `update_ticket_state` | Update ticket lifecycle timestamps |
+| `get_ticket_state` | Get ticket tracking state and timestamps |
+| `list_config_fields` | List available configuration fields |
+| `get_config_field` | Get a configuration field value |
+| `update_config_field` | Update a configuration field |
+| `get_my_role` | Check role and permissions for the current API key |
+| `get_jira_transitions` | List available Jira status transitions |
+| `update_jira_status` | Transition a ticket to a new status |
+| `resolve_target_status` | Resolve the post-PR target status for a project |
+| `create_pull_request` | Create a pull request |
+| `resolve_ci_checks` | Discover and classify CI checks |
+| `poll_ci_checks` | Poll CI check status |
+| `get_docs_dir` | Return the configured docs directory path |
+| `list_pipelines` | List available pipeline recipes |
+| `get_pipeline_recipe` | Retrieve a resolved pipeline recipe |
+
+### Pipeline Recipes
+
+The `list_pipelines` and `get_pipeline_recipe` tools provide access to declarative multi-step workflow recipes (e.g., `implement-ticket`, `review-ticket`, `full-lifecycle`). These are resolved locally from bundled definitions — no additional server calls are needed.
+
+## Publishing
+
+This package uses tag-based publishing. To release a new version:
+
+```bash
+cd mcp_server
+npm version patch    # creates tag mcp-server/v0.1.1
+git push --follow-tags
+```
+
+The GitHub Actions workflow triggers on `mcp-server/v*` tags and publishes to npm with provenance.
+
+## License
+
+MIT