Metadata-Version: 2.4
Name: synapps-mcp
Version: 1.4.1
Summary: Code intelligence MCP server — indexes codebases into a queryable graph of symbols, call chains, and relationships
Project-URL: Homepage, https://github.com/SynappsCodeComprehension/synapps
Project-URL: Source, https://github.com/SynappsCodeComprehension/synapps
Project-URL: Issues, https://github.com/SynappsCodeComprehension/synapps/issues
Project-URL: Changelog, https://github.com/SynappsCodeComprehension/synapps/blob/main/CHANGELOG.md
License: MIT
License-File: LICENSE
License-File: NOTICES
Keywords: code-intelligence,graph-database,language-server-protocol,mcp,tree-sitter
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: charset-normalizer>=3.0.0
Requires-Dist: docker>=7.0.0
Requires-Dist: joblib>=1.3.0
Requires-Dist: mcp-config-path>=0.1.3
Requires-Dist: mcp>=1.0.0
Requires-Dist: neo4j>=5.0.0
Requires-Dist: overrides>=7.7.0
Requires-Dist: pathspec>=0.12.1
Requires-Dist: psutil>=7.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pyright>=1.1.0
Requires-Dist: requests>=2.31.0
Requires-Dist: sensai-utils>=1.5.0
Requires-Dist: tree-sitter-c-sharp>=0.23.0
Requires-Dist: tree-sitter-java>=0.23.0
Requires-Dist: tree-sitter-python>=0.25.0
Requires-Dist: tree-sitter-typescript>=0.23.2
Requires-Dist: tree-sitter>=0.24.0
Requires-Dist: typer>=0.12.0
Requires-Dist: watchdog>=4.0.0
Provides-Extra: dev
Requires-Dist: pytest-timeout>=2.0.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# Synapps

Code intelligence MCP server — gives AI coding agents a queryable graph of your codebase.

## What it does

- Indexes C#, Python, TypeScript/JavaScript, and Java codebases using tree-sitter and Language Server Protocol
- Stores symbols, call chains, and relationships in a Memgraph graph database
- Exposes semantic query tools as MCP tools — AI agents can find usages, trace call trees, and analyze change impact without reading every file
- Supports incremental sync via git-diff-based change detection and live file watching

## Install

```
pip install synapps-mcp
docker compose up -d
```

The `docker compose up -d` command starts a local Memgraph instance (required for the graph database).

## Configure your MCP client

Add Synapps to your MCP client configuration (e.g., Claude Code `~/.claude.json`):

```json
{
  "mcpServers": {
    "synapps": {
      "command": "synapps-mcp"
    }
  }
}
```

Then index your project:

```
synapps index /path/to/your/project
```

## Supported Languages

- C#
- Python
- TypeScript / JavaScript
- Java

## Key MCP Tools

- `get_context_for` — full context for a symbol before editing (callers, callees, tests); use `scope="impact"` for change impact analysis
- `find_usages` — who calls a method or uses any symbol across the codebase
- `find_callees` — what a method depends on downstream
- `find_entry_points` — find API/controller entry points reaching a method
- `search_symbols` — find symbols by name, kind, file, or namespace

## Links

- [GitHub](https://github.com/SynappsCodeComprehension/synapps)
- [Changelog](https://github.com/SynappsCodeComprehension/synapps/blob/main/CHANGELOG.md)
