k8s deployment
This commit is contained in:
@@ -12,17 +12,18 @@ Transport: **streamable-http** (persistent process, independent of Claude Code s
|
||||
|
||||
## Key files
|
||||
|
||||
- `docker-compose.yml` — defines the `mcp-atlassian` container (image `ghcr.io/sooperset/mcp-atlassian:latest`, port 9000)
|
||||
- `compose/docker-compose.yml` — defines the `mcp-atlassian` container (image `ghcr.io/sooperset/mcp-atlassian:latest`, port 9000)
|
||||
- `k8s/` — Kubernetes manifests (namespace `mcp`, secret, deployment, service)
|
||||
- `.env` — Jira credentials (`JIRA_URL`, `JIRA_USERNAME`, `JIRA_API_TOKEN`); never commit this file
|
||||
- `.mcp.json` — tells Claude Code to connect to `http://localhost:9000/mcp`; auto-loaded when Claude Code opens this directory
|
||||
|
||||
## Common commands
|
||||
|
||||
```bash
|
||||
docker compose up -d # start the server
|
||||
docker compose down # stop the server
|
||||
docker compose logs -f # tail logs
|
||||
docker compose pull && docker compose up -d # update to latest image
|
||||
docker compose -f compose/docker-compose.yml up -d # start the server
|
||||
docker compose -f compose/docker-compose.yml down # stop the server
|
||||
docker compose -f compose/docker-compose.yml logs -f # tail logs
|
||||
docker compose -f compose/docker-compose.yml pull && docker compose -f compose/docker-compose.yml up -d # update to latest image
|
||||
```
|
||||
|
||||
## Credentials
|
||||
@@ -35,6 +36,23 @@ Credentials live in `.env` (already in `.gitignore`). Required variables:
|
||||
| `JIRA_USERNAME` | Atlassian account email |
|
||||
| `JIRA_API_TOKEN` | Atlassian API token — generate at id.atlassian.com |
|
||||
|
||||
## Kubernetes deployment
|
||||
|
||||
```bash
|
||||
# 1. Create the secret from .env
|
||||
kubectl create secret generic mcp-jira-credentials -n mcp \
|
||||
--from-literal=JIRA_URL="$(grep JIRA_URL .env | cut -d= -f2-)" \
|
||||
--from-literal=JIRA_USERNAME="$(grep JIRA_USERNAME .env | cut -d= -f2-)" \
|
||||
--from-literal=JIRA_API_TOKEN="$(grep JIRA_API_TOKEN .env | cut -d= -f2-)" \
|
||||
--dry-run=client -o yaml | kubectl apply -f -
|
||||
|
||||
# 2. Apply all manifests
|
||||
kubectl apply -f k8s/
|
||||
|
||||
# 3. Access locally via port-forward
|
||||
kubectl port-forward -n mcp svc/mcp-jira 9000:9000
|
||||
```
|
||||
|
||||
## MCP tools
|
||||
|
||||
Once the server is running and Claude Code is connected, Jira tools are available directly in this session (search issues, create/update tickets, etc.). The MCP server exposes the full mcp-atlassian tool surface.
|
||||
|
||||
Reference in New Issue
Block a user