Bob Demo MCP Server

A comprehensive MCP (Model Context Protocol) server that demonstrates Bob's capabilities through 9 specialized tools for file operations, code analysis, and git operations.

Features

📁 File Operations (3 tools)

• list_directory - Browse project files and folders with optional recursive listing

• read_file_content - Read files with line numbers and optional line range selection

• search_in_files - Search across multiple files using regex patterns with context

🔍 Code Analysis (3 tools)

• analyze_project_structure - Get comprehensive project insights including file types, technologies, and structure

• find_code_definitions - Find functions, classes, methods, and interfaces in code

• analyze_code_complexity - Measure code metrics including lines, functions, and complexity

🔀 Git Operations (3 tools)

• get_git_diff - View changes and diffs with statistics

• get_repository_info - Get repository status, branch info, and commit details

• analyze_commit_history - Analyze commit patterns and contributor statistics

Installation

# Install dependencies
npm install

# Build the server
npm run build

Usage

This server is designed to be used with Bob AI Assistant through the MCP protocol. Once configured in Bob's MCP settings, the tools will be automatically available.

Configuration

Add to Bob's MCP settings (~/.bob/settings/mcp_settings.json):

{
  "mcpServers": {
    "bob-demo": {
      "command": "node",
      "args": ["/Users/ahmedchaudhry/Documents/IBM Bob/MCP/bob-demo-server/build/index.js"],
      "disabled": false,
      "alwaysAllow": [],
      "disabledTools": []
    }
  }
}

Example Usage

Once configured, you can ask Bob naturally:

• "List all files in the current directory"

• "Analyze this project's structure"

• "Find all TODO comments in the code"

• "Show me what I've changed in git"

• "What functions are defined in this file?"

• "How complex is this code?"

Bob will automatically use the appropriate tools to answer your questions.

Development

# Watch mode for development
npm run watch

# Build
npm run build

Architecture

bob-demo-server/
├── src/
│   ├── index.ts              # Main server entry point
│   ├── tools/
│   │   ├── file-operations.ts    # File operation tools
│   │   ├── code-analysis.ts      # Code analysis tools
│   │   └── git-operations.ts     # Git operation tools
│   └── utils/
│       ├── file-utils.ts         # File system utilities
│       ├── git-utils.ts          # Git command utilities
│       └── parser-utils.ts       # Code parsing utilities
├── build/                    # Compiled JavaScript output
├── package.json
├── tsconfig.json
└── README.md

Requirements

• Node.js 18 or higher

• Git (for git operation tools)

• TypeScript 5.3 or higher

License

MIT

Author

Bob AI Assistant