# code-tree-mcp

An MCP server in Node.js + TypeScript that indexes source code into a local code-tree database for:

- JavaScript / TypeScript
- Java
- Python

The server stores symbols and dependencies per file and exposes MCP tools to query the indexed tree.

## Features

- Incremental indexing based on file modification time
- Local persisted database in `.code-tree/code-tree.db`
- Symbol extraction for classes, interfaces, types, functions, and methods (language-dependent)
- Dependency extraction for imports/requires/packages
- MCP tools for indexing, listing tree data, symbol search, and dependency queries

## Install

```bash
npm install
```

## Build

```bash
npm run build
```

## Run

```bash
npm run start
```

For development:

```bash
npm run dev
```

## MCP Tools

The server exposes these tools:

- `index_codebase`
  - Inputs:
    - `workspacePath` (required, absolute path)
    - `forceReindex` (optional boolean)
- `get_code_tree`
  - Inputs:
    - `workspacePath` (required)
    - `pathPrefix` (optional, workspace-relative prefix)
    - `limit` (optional)
- `get_file_symbols`
  - Inputs:
    - `workspacePath` (required)
    - `filePath` (required, workspace-relative)
- `search_symbols`
  - Inputs:
    - `workspacePath` (required)
    - `query` (required)
    - `language` (optional: `javascript`, `typescript`, `java`, `python`)
    - `nodeType` (optional: `module`, `class`, `interface`, `type`, `function`, `method`)
    - `limit` (optional)
- `get_dependencies`
  - Inputs:
    - `workspacePath` (required)
    - `filePath` (optional)
    - `dependency` (optional)
    - `limit` (optional)

## Example MCP Server Configuration

Use your MCP client configuration format to register:

```json
{
  "mcpServers": {
    "code-tree": {
      "command": "node",
      "args": ["/absolute/path/to/code-tree-mcp/dist/index.js"]
    }
  }
}
```

During active development, you can point to TS entry via `tsx`:

```json
{
  "mcpServers": {
    "code-tree": {
      "command": "npx",
      "args": ["tsx", "/absolute/path/to/code-tree-mcp/src/index.ts"]
    }
  }
}
```

## Notes

- This implementation uses robust regex-based parsing for broad compatibility.
- For deeper AST-level semantic analysis, the parser layer can be upgraded per language.