Skip to main content
Glama

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

Related MCP server: MCP Demo Server

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

Available Tools

9 tools
analyze_code_complexityD

Inputs: file_path (required).

analyze_commit_historyD

Inputs: repository_path (required), count, author.

analyze_project_structureD

Inputs: path (required).

find_code_definitionsD

Inputs: path (required), language, definition_type.

get_git_diffD

Inputs: repository_path (required), branch, staged, file_path.

get_repository_infoD

Inputs: path (required).

list_directoryD

Inputs: path (required), recursive.

read_file_contentD

Inputs: path (required), end_line, start_line.

search_in_filesD

Inputs: pattern (required), directory (required), max_results, file_extension.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.1/5.0

    Scored across 9 tools

    Disambiguation4/5

    Tools have distinct names covering different aspects (analysis, navigation, file operations), but lack descriptions could cause some ambiguity between similar-sounding tools like analyze_code_complexity and analyze_project_structure.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with snake_case (e.g., analyze_code_complexity, get_repository_info, list_directory). No mixed conventions.

    Tool Count5/5

    9 tools is well-scoped for a code analysis server, covering analysis, navigation, file reading, and searching without being overwhelming.

    Completeness4/5

    The set covers common code analysis tasks (complexity, history, structure, definitions, diff, file operations). Minor gaps like missing metadata or branch comparison, but overall sufficient for the inferred domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A tutorial MCP server for learning the Model Context Protocol by building file and system tools. Provides hands-on experience creating custom tools that enable AI models to interact with files and execute system commands.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      A demonstration MCP server showcasing tools (calculator, file operations, weather, timestamp), resources (server config, system info, documentation), and reusable prompt templates for code review, documentation, and debugging.
      Apache 2.0
    • A
      license
      C
      quality
      D
      maintenance
      A comprehensive MCP server that provides AI assistants with tools for file system management, Git integration, and shell command execution. It features specialized code utilities for analysis, formatting, and linting to enhance development workflows within Claude Desktop.
      28
      7
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A modular MCP server that provides tools for file operations, regex-based code searching, and structural analysis of functions and classes across multiple programming languages. It also includes AI-powered features for intelligently updating files according to architectural changes.
      -