# mcp-beacon

Source: https://glimind.com/server/pypi%2Fmcp-beacon
Registry id: `pypi/mcp-beacon`
Status: unknown

## Install

```json
{
  "mcpServers": {
    "mcp-beacon": {
      "command": "uvx",
      "args": [
        "mcp-beacon"
      ]
    }
  }
}
```

Claude Code:

```sh
claude mcp add mcp-beacon -- uvx mcp-beacon
```

## Tools (26)

- `ast_query`: Tree-sitter query for precise structure
- `ast_structure`: File outline (functions, classes, imports)
- `code_metrics`: File sizes, line counts, complexity
- `codebase_diff`: Git changes, history, statistics
- `codebase_summary`: Project overview (languages, files, modules)
- `find_files`: Glob pattern file discovery
- `find_similar`: Find similar code blocks
- `find_tests`: Find tests for a function or uncovered code
- `git_blame`: Who wrote each line
- `git_branches`: List branches
- `git_conflicts`: Find merge conflicts
- `git_history`: Structured commit history
- `git_status`: Working tree status
- `list_files`: Directory listing
- `read_file`: Read file contents
- `search_by_pattern`: Structural search (signatures, classes)
- `search_codebase`: Text/regex search with context snippets
- `search_codebase_count`: Count matches per file (no snippets)
- `search_codebase_multi`: Multi-query search (single scan)
- `search_definitions`: Find function/class definitions by name
- `search_docs`: Search documentation and comments
- `search_imports`: Dependency graph (what imports what)
- `search_references`: Find all usages of a function/variable
- `semantic_index`: Build/update semantic index
- `semantic_search`: Search by meaning with embeddings
- `semantic_stats`: Index statistics

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.