Reviewed overview

MCP 服务器概览

AI-CMS - Context and Project Management Platform

Last Updated June 2, 2025 5:49 PM EST

🚀 One-command deployment of a complete AI-CMS instance with VS Code/Cursor IDE extensions.

📚 Complete Documentation: See AI-CMS-DOCUMENTATION.md for comprehensive API reference, GraphQL schema, and operational guides.

✨ Key Features

🔶 Deep Jira Integration: Native epic, user story, sprint management with real-time webhooks
🐙 GitHub Automation: Repository creation, branch management, deployment tracking
🖥️ IDE Extensions: Multiple VS Code/Cursor panels for enhanced productivity
🔍 AI-Powered Search: AutoRAG semantic documentation search
📊 Real-time Dashboards: Sprint progress, deployment status, project health
⚡ Automated Workflows: Project creation, sprint planning, deployment pipelines
🌐 Global Edge Deployment: Cloudflare Workers with sub-100ms response times

🚀 Quick Start

Prerequisites

Cloudflare Account with Workers, D1, R2, and AutoRAG access
Jira Instance (Atlassian Cloud or Server) with API access
GitHub Account with repository creation permissions
Docker installed on your system

Required Tokens

# Cloudflare (required)
export CLOUDFLARE_ACCOUNT_ID="your-cloudflare-account-id"
export CLOUDFLARE_API_TOKEN="your-cloudflare-api-token"

# Jira Integration (required)
export JIRA_DOMAIN="yourcompany.atlassian.net"
export JIRA_API_TOKEN="your-jira-api-token"
export JIRA_PROJECT_KEY="PROJ"

# GitHub Integration (required)
export GITHUB_TOKEN="ghp_your-github-token"

# Optional integrations
export SLACK_BOT_TOKEN="xoxb-your-slack-bot-token"

One-Command Deployment

docker run --rm \
  -e CLOUDFLARE_ACCOUNT_ID="$CLOUDFLARE_ACCOUNT_ID" \
  -e CLOUDFLARE_API_TOKEN="$CLOUDFLARE_API_TOKEN" \
  -e JIRA_DOMAIN="$JIRA_DOMAIN" \
  -e JIRA_API_TOKEN="$JIRA_API_TOKEN" \
  -e JIRA_PROJECT_KEY="$JIRA_PROJECT_KEY" \
  -e GITHUB_TOKEN="$GITHUB_TOKEN" \
  -e SLACK_BOT_TOKEN="$SLACK_BOT_TOKEN" \
  ai-cms-fresh:latest

🏗️ What Gets Created

Cloudflare Infrastructure

Worker: AI-CMS API with Jira and GitHub integration
D1 Database: Complete schema with Jira epics, user stories, sprints, deployments
KV Namespace: Caching layer for API responses
R2 Bucket: File storage for project assets and documentation

Jira Integration

Epic Tracking: Automatic epic creation and synchronization
User Stories: Story point estimation and sprint assignment
Sprint Management: Sprint planning, tracking, and completion
Webhook Endpoints: Real-time updates from Jira to AI-CMS

GitHub Integration

Repository Creation: Automatic project repository setup
Branch Management: Feature branch creation linked to Jira issues
Pull Request Tracking: PR status synchronized with Jira stories
Webhook Endpoints: GitHub events trigger AI-CMS updates

IDE Extensions

Jira Calendar Panel: Sprint timelines, milestones, and deadlines
Project Architecture Panel: Repository structure and dependencies
Sprint Dashboard: Current sprint progress and team velocity
Deployment Panel: Deployment status, history, and rollback controls
AutoRAG Search Panel: Intelligent documentation search

📊 API Overview

GraphQL API: Complete CRUD operations with Jira and GitHub integration
Webhook Endpoints: Real-time Jira and GitHub event processing
IDE Integration: Multiple panel endpoints for VS Code/Cursor extensions
AutoRAG Search: AI-powered documentation search and retrieval

📚 Full API Reference: See AI-CMS-DOCUMENTATION.md for complete endpoint documentation and GraphQL schema.

🔧 Configuration Options

Environment Variables

Variable	Required	Description	Example
`CLOUDFLARE_ACCOUNT_ID`	✅	Cloudflare account ID	`abc123...`
`CLOUDFLARE_API_TOKEN`	✅	API token with Workers, D1, R2, AutoRAG permissions	`xyz789...`
`JIRA_DOMAIN`	✅	Jira instance domain	`company.atlassian.net`
`JIRA_API_TOKEN`	✅	Jira API token	`ATATT3x...`
`JIRA_PROJECT_KEY`	✅	Jira project key	`PROJ`
`GITHUB_TOKEN`	✅	GitHub token with repo permissions	`ghp_abc123...`
`INSTANCE_NAME`	❌	Instance name	`ai-cms`
`AUTORAG_INSTANCE_NAME`	❌	AutoRAG instance name	`ai-cms-docs`
`SLACK_CHANNEL_NAME`	❌	Slack channel name	`ai-cms`
`SLACK_BOT_TOKEN`	❌	Slack bot token	`xoxb-123...`
`ENVIRONMENT`	❌	Deployment environment	`production`
`DRY_RUN`	❌	Test mode without creating resources	`false`

Advanced Configuration

# Custom instance configuration
docker run --rm \
  -e CLOUDFLARE_ACCOUNT_ID="$CLOUDFLARE_ACCOUNT_ID" \
  -e CLOUDFLARE_API_TOKEN="$CLOUDFLARE_API_TOKEN" \
  -e JIRA_DOMAIN="$JIRA_DOMAIN" \
  -e JIRA_API_TOKEN="$JIRA_API_TOKEN" \
  -e JIRA_PROJECT_KEY="$JIRA_PROJECT_KEY" \
  -e GITHUB_TOKEN="$GITHUB_TOKEN" \
  -e INSTANCE_NAME="my-project" \
  -e AUTORAG_INSTANCE_NAME="my-project-docs" \
  -e SLACK_CHANNEL_NAME="my-project-team" \
  -e ENVIRONMENT="staging" \
  ai-cms-fresh:latest

🧪 Testing Your Instance

Health Check

curl https://your-instance.workers.dev/health

GraphQL Query

curl -X POST https://your-instance.workers.dev/graphql \
  -H "Content-Type: application/json" \
  -d '{
    "query": "query { 
      projects { 
        id 
        name 
        jira_project_key 
        github_repo_url 
      } 
    }"
  }'

IDE Integration Test

curl https://your-instance.workers.dev/ide/sidebar/context

Jira Webhook Test

curl -X POST https://your-instance.workers.dev/webhooks/jira \
  -H "Content-Type: application/json" \
  -d '{
    "webhookEvent": "jira:issue_created",
    "issue": {
      "key": "PROJ-123",
      "fields": {
        "summary": "Test issue"
      }
    }
  }'

🖥️ IDE Extension Setup

VS Code/Cursor Configuration

Install Recommended Extensions:

code --install-extension atlassian.atlascode
code --install-extension ms-vscode.vscode-slack
code --install-extension ai-cms.project-intelligence

Configure Settings (add to settings.json):

{
  "ai-cms.apiEndpoint": "https://your-instance.workers.dev",
  "ai-cms.jiraIntegration": {
    "domain": "yourcompany.atlassian.net",
    "projectKey": "PROJ",
    "enabled": true
  },
  "ai-cms.githubIntegration": {
    "enabled": true
  },
  "ai-cms.panels": {
    "jiraCalendar": true,
    "projectArchitecture": true,
    "sprintDashboard": true,
    "deploymentPanel": true,
    "autoragSearch": true
  }
}

Available Panels

📅 Jira Calendar: Sprint timelines, milestones, and deadlines
🏗️ Project Architecture: Repository structure and dependencies
📊 Sprint Dashboard: Current sprint progress and team velocity
🚀 Deployment Panel: Deployment status, history, and rollback controls
🔍 AutoRAG Search: Intelligent documentation search and retrieval

⚡ Action Triggers

Built-in Workflows

Create Project:
- Creates GitHub repository
- Creates Jira epic
- Sets up project calendar
- Configures IDE workspace
- Tracks initial deployment
Plan Sprint:
- Analyzes epic breakdown
- Estimates story points
- Assigns team capacity
- Creates sprint calendar
- Updates IDE dashboard
Deploy Project:
- Validates deployment readiness
- Creates deployment record
- Executes deployment
- Updates deployment status
- Notifies team completion
Start Thread:
- Creates GitHub branch
- Creates Jira subtask
- Updates IDE sidebar
- Links thread to repository
Close Thread:
- Merges GitHub branch
- Updates Jira issue status
- Archives thread documentation
- Updates sprint progress

Trigger Actions via GraphQL

mutation TriggerAction($action: String!, $params: String!) {
  triggerAction(action: $action, params: $params) {
    success
    message
    data
  }
}

🔄 Webhook Configuration

Jira Webhooks

Configure Jira webhooks to point to your instance:

Webhook URL: https://your-instance.workers.dev/webhooks/jira

Events:

Issue created
Issue updated
Issue deleted
Sprint started
Sprint completed
Epic created
Epic updated

GitHub Webhooks

Configure GitHub webhooks for your repositories:

Webhook URL: https://your-instance.workers.dev/webhooks/github

Events:

Push
Pull request
Issues
Releases
Deployments

📊 GraphQL Schema Overview

The AI-CMS Fresh GraphQL API provides comprehensive access to:

Projects: Full project lifecycle with Jira epic and GitHub repository linking
Jira Integration: Epics, user stories, sprints with real-time synchronization
GitHub Integration: Repository management and deployment tracking
Calendar Events: Sprint planning and milestone tracking
IDE Context: Multi-panel configuration and state management

📚 Complete Schema: See AI-CMS-DOCUMENTATION.md for full GraphQL schema, input types, and example queries.

🛠️ Management Commands

Container Commands

# Check instance status
docker run --rm \
  -e CLOUDFLARE_ACCOUNT_ID="$CLOUDFLARE_ACCOUNT_ID" \
  -e CLOUDFLARE_API_TOKEN="$CLOUDFLARE_API_TOKEN" \
  -e JIRA_DOMAIN="$JIRA_DOMAIN" \
  -e JIRA_API_TOKEN="$JIRA_API_TOKEN" \
  -e JIRA_PROJECT_KEY="$JIRA_PROJECT_KEY" \
  -e GITHUB_TOKEN="$GITHUB_TOKEN" \
  ai-cms-fresh:latest status

# Run comprehensive tests
docker run --rm \
  -e CLOUDFLARE_ACCOUNT_ID="$CLOUDFLARE_ACCOUNT_ID" \
  -e CLOUDFLARE_API_TOKEN="$CLOUDFLARE_API_TOKEN" \
  -e JIRA_DOMAIN="$JIRA_DOMAIN" \
  -e JIRA_API_TOKEN="$JIRA_API_TOKEN" \
  -e JIRA_PROJECT_KEY="$JIRA_PROJECT_KEY" \
  -e GITHUB_TOKEN="$GITHUB_TOKEN" \
  ai-cms-fresh:latest test

# Show IDE setup instructions
docker run --rm \
  -e CLOUDFLARE_ACCOUNT_ID="$CLOUDFLARE_ACCOUNT_ID" \
  -e CLOUDFLARE_API_TOKEN="$CLOUDFLARE_API_TOKEN" \
  -e JIRA_DOMAIN="$JIRA_DOMAIN" \
  -e JIRA_API_TOKEN="$JIRA_API_TOKEN" \
  -e JIRA_PROJECT_KEY="$JIRA_PROJECT_KEY" \
  -e GITHUB_TOKEN="$GITHUB_TOKEN" \
  ai-cms-fresh:latest setup-ide

# Clean up all resources
docker run --rm \
  -e CLOUDFLARE_ACCOUNT_ID="$CLOUDFLARE_ACCOUNT_ID" \
  -e CLOUDFLARE_API_TOKEN="$CLOUDFLARE_API_TOKEN" \
  -e JIRA_DOMAIN="$JIRA_DOMAIN" \
  -e JIRA_API_TOKEN="$JIRA_API_TOKEN" \
  -e JIRA_PROJECT_KEY="$JIRA_PROJECT_KEY" \
  -e GITHUB_TOKEN="$GITHUB_TOKEN" \
  ai-cms-fresh:latest clean

🔒 Security & Permissions

Required Cloudflare Permissions

Workers: Create and deploy workers
D1: Create databases and execute queries
KV: Create namespaces and manage keys
R2: Create buckets and manage objects
AutoRAG: Create and manage instances

Required Jira Permissions

Project Administration: Access to project settings
Issue Management: Create, read, update issues
Sprint Management: Manage sprints and boards
Webhook Configuration: Set up webhook endpoints

Required GitHub Permissions

Repository Creation: Create new repositories
Repository Administration: Manage repository settings
Webhook Management: Configure repository webhooks
Branch Protection: Manage branch protection rules

🚨 Troubleshooting

Common Issues

Jira Connection Failed

# Verify Jira credentials
curl -H "Authorization: Bearer $JIRA_API_TOKEN" \
  "https://$JIRA_DOMAIN/rest/api/3/myself"

GitHub Repository Creation Failed

# Verify GitHub token permissions
curl -H "Authorization: token $GITHUB_TOKEN" \
  "https://api.github.com/user"

Worker Deployment Failed

# Check Cloudflare account permissions
curl -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  "https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID"

IDE Extensions Not Working
- Verify API endpoint is accessible
- Check VS Code/Cursor extension settings
- Ensure IDE configuration is properly applied

Debug Mode

# Run in dry-run mode to test configuration
docker run --rm \
  -e CLOUDFLARE_ACCOUNT_ID="$CLOUDFLARE_ACCOUNT_ID" \
  -e CLOUDFLARE_API_TOKEN="$CLOUDFLARE_API_TOKEN" \
  -e JIRA_DOMAIN="$JIRA_DOMAIN" \
  -e JIRA_API_TOKEN="$JIRA_API_TOKEN" \
  -e JIRA_PROJECT_KEY="$JIRA_PROJECT_KEY" \
  -e GITHUB_TOKEN="$GITHUB_TOKEN" \
  -e DRY_RUN="true" \
  ai-cms-fresh:latest

📈 Monitoring & Analytics

Built-in Metrics

Deployment Success Rate: Track deployment success/failure rates
Jira Sync Status: Monitor Jira webhook processing
GitHub Integration Health: Track repository and webhook status
IDE Usage Analytics: Monitor panel usage and user engagement
AutoRAG Search Performance: Track search queries and results

Custom Dashboards

Project Health Dashboard: Overall project status and metrics
Sprint Progress Dashboard: Sprint burndown and velocity charts
Deployment Pipeline Dashboard: Deployment frequency and success rates
Team Productivity Dashboard: Issue completion and code commit metrics

🤝 Contributing

Fork the repository
Create a feature branch
Make your changes
Test with dry-run mode
Submit a pull request

📄 License

MIT License with Attribution - see LICENSE file for details.

Attribution: When using AI-CMS, please include link to this repository.

🆘 Support

admin_at_adamic_dot_tech

Ai Cms Fresh Docker