Setup Guide

Get DevChronicle MCP up and running in minutes

Step 1 of 7

Prerequisites

Before you begin, make sure you have these installed

๐Ÿณ

Docker Desktop

Required for running the MCP server

๐Ÿค–

IBM Bob IDE

Your AI-powered development assistant

โœ…

No Node.js Required

Everything runs inside Docker - your host stays clean!

Optional

Installation Steps

Follow these steps in order

1

Clone the Repository

โฑ๏ธ 1 minute

Get the DevChronicle MCP source code on your machine

bash
git clone https://github.com/yourusername/devchronicle-mcp.git
cd devchronicle-mcp
2

Build Docker Image

โฑ๏ธ 2-3 minutes

Create the Docker container with Node.js and all dependencies

bash
docker compose build
Expected Output:
[+] Building 45.2s (12/12) FINISHED
 => [internal] load build definition
 => => transferring dockerfile: 234B
 => [internal] load .dockerignore
 ...
 => => naming to docker.io/library/devchronicle-mcp
3

Install Dependencies

โฑ๏ธ 1 minute

Install Node.js packages inside the Docker container

bash
docker compose run --rm devchronicle-mcp npm install
4

Build TypeScript

โฑ๏ธ 30 seconds

Compile TypeScript to JavaScript

bash
docker compose run --rm devchronicle-mcp npm run build
Expected Output:
> devchronicle-mcp@1.0.0 build
> tsc
5

Verify Installation

โฑ๏ธ 10 seconds

Run the smoke test to ensure everything works

bash
docker compose run --rm devchronicle-mcp node scripts/smoke-test.mjs
โœ… Expected Output:
๐Ÿงช Starting MCP server smoke test...
โœ… Server started successfully
โœ… All expected tools found: [ 'log_progress', 'summarize_project_state', 'analyze_change_risk', 'create_adr', 'recommend_next_features' ]
๐ŸŽ‰ Smoke test passed!
6

Configure Bob IDE

โฑ๏ธ 2 minutes

Set up Bob to use DevChronicle MCP

Create or edit .Bob/mcp.json in your project root:

json
{
  "mcpServers": {
    "devchronicle": {
      "command": "powershell",
      "args": [
        "-ExecutionPolicy",
        "Bypass",
        "-File",
        "scripts/start-mcp.ps1"
      ],
      "description": "DevChronicle MCP - Persistent project memory"
    }
  }
}

Create or edit .Bob/mcp.json in your project root:

json
{
  "mcpServers": {
    "devchronicle": {
      "command": "sh",
      "args": [
        "scripts/start-mcp.sh"
      ],
      "description": "DevChronicle MCP - Persistent project memory"
    }
  }
}
7

Restart Bob IDE

โฑ๏ธ 30 seconds

Restart Bob or reload the MCP configuration to activate DevChronicle

๐Ÿ”„

Restart Bob IDE

Close and reopen Bob completely

โšก

Reload MCP Config

Use Bob's command palette to reload MCP servers

Troubleshooting

๐Ÿณ Docker Issues

Problem: Docker commands fail

Solution: Ensure Docker Desktop is running

docker ps

๐Ÿ”จ Build Errors

Problem: TypeScript compilation fails

Solution: Clean and rebuild

docker compose build --no-cache

๐Ÿค– Bob Connection

Problem: Bob can't find MCP server

Solution: Check config file path and restart Bob