🔌 Deploy KiroForge MCP Server

Centralized steering pack and hooks management for your team

📋 Prerequisites

Before deploying the MCP Server, ensure you have the following installed:

Java 17+

Required for building Lambda functions

java --version
📦

Maven

Build tool for Java projects

mvn --version
☁️

AWS CLI

Configured with your AWS credentials

aws configure
🏗️

AWS CDK

Infrastructure as Code toolkit

npm install -g aws-cdk

🚀 Deployment Steps

Step 1: Clone the Repository

git clone https://github.com/AdamBien/kiro-forge.git
cd kiro-forge/kiro-forge

Step 2: Bootstrap CDK (First Time Only)

cd cdk
cdk bootstrap

This sets up the necessary AWS resources for CDK deployments in your account.

Step 3: Deploy the MCP Server

cd ..
./buildAndDeployDontAsk.sh

This script builds the Lambda functions and deploys the entire stack.

Step 4: Get Your Configuration

After deployment, get your MCP server URL and User Pool Client ID from the CloudFormation outputs:

aws cloudformation describe-stacks \
--stack-name KiroForgeStack \
--query 'Stacks[0].Outputs'

⚙️ Configure Kiro IDE

1. Get Your Access Token

Authenticate with AWS Cognito to get your access token:

export TOKEN=$(aws cognito-idp initiate-auth \
--region us-west-2 \
--auth-flow USER_PASSWORD_AUTH \
--client-id <YOUR_CLIENT_ID> \
--auth-parameters USERNAME=<email>,PASSWORD=<password> \
--query 'AuthenticationResult.AccessToken' \
--output text)

2. Add MCP Server to Kiro IDE

Add this configuration to .kiro/settings/mcp.json:

{
  "mcpServers": {
    "kiro-forge": {
      "url": "<YOUR_GATEWAY_URL>/mcp",
      "headers": {
        "Authorization": "Bearer ${TOKEN}"
      },
      "disabled": false,
      "autoApprove": [
        "SteeringsRetriever___fetchSteerings"
      ]
    }
  }
}

3. Launch Kiro IDE

Launch Kiro IDE from the same terminal where you exported the TOKEN:

kiro .

✨ What You Get

📦

Centralized Steerings

Store and share coding standards across your team

🎯

Agent Hooks

Automated validation and quality checks

🔄

Real-Time Sync

Updates propagate instantly across all developers

🔌

MCP Protocol

Works with Kiro IDE, VSCode, and Q CLI

Need Help?

If you encounter any issues during deployment, check out our documentation or reach out on GitHub.