pypi silex-archaeologystdioMITupdated 9d ago
Understand the codebase before changing the code.
What can you do with silex?
Silex — evidence-based code archaeology
Understand the codebase before changing the code.
Silex reconstructs architecture, dependencies, workflows and business rules
from your source code — and serves that understanding to your AI coding
agents via MCP. Every claim is anchored to
file:line with a verified quote. What Silex can't prove, it tells you.
Local-first. Your code never leaves your machine. No account, no card, no telemetry.
→ Site & docs: https://silex.tec.br · Concepts · MCP tool reference · llms.txt
Install (free tier)
# Python 3.10+
pip install silex-archaeology
Until the PyPI release lands you can install the wheel from Releases:
pip install https://github.com/silex-tec/silex/releases/latest/download/silex_archaeology-py3-none-any.whl
Connect it to your MCP client (Claude Code, Cursor, Claude Desktop, Windsurf, Cline, Continue, Zed) — stdio config:
{
"mcpServers": {
"silex": { "command": "silex-mcp-server", "args": ["serve", "--stdio"] }
}
}
Full install guide (Windows/PowerShell notes included): https://silex.tec.br/docs/
Try it on a real codebase
Clone Microsoft's eShop (MIT) and point a scan at it — the Concepts page shows the community graph, the recovered order state machine and anchored findings from that exact scan, so you can compare your output against a published reference.
What you get (free)
- Local MCP server, full codebase scan (C#, JS/TS, Java, PHP, COBOL, VB…)
- Community map — the real shape of the system, vendor/generated classified out of the way by default
- Evidence anchored to
file:line, confidence with provenance - Unknown-territory detection: what can't be proven is flagged, not guessed
- Shareable evidence report
- Works with the AI seat you already pay for
Pro tier (team workspaces, deep architecture visualization, refactoring trust contracts): coming soon — join the waitlist.
Issues & feedback
Bug reports and field feedback are welcome in Issues. The engine is proprietary; this repository hosts distribution, documentation and the public roadmap conversation.
© 2026 SILEX. All rights reserved.
Install
Add silex to your client. Pick the one you use.
claude mcp add silex-archaeology -- uvx silex-archaeologycodex mcp add silex-archaeology -- uvx silex-archaeologyamp mcp add silex-archaeology -- uvx silex-archaeology{
"mcpServers": {
"silex-archaeology": {
"command": "uvx",
"args": [
"silex-archaeology"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"silex-archaeology": {
"command": "uvx",
"args": [
"silex-archaeology"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"silex-archaeology","command":"uvx","args":["silex-archaeology"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"silex-archaeology": {
"command": "uvx",
"args": [
"silex-archaeology"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"silex-archaeology": {
"command": "uvx",
"args": [
"silex-archaeology"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"silex-archaeology": {
"command": "uvx",
"args": [
"silex-archaeology"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"silex-archaeology": {
"type": "local",
"command": "uvx",
"args": [
"silex-archaeology"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"silex-archaeology": {
"command": {
"path": "uvx",
"args": [
"silex-archaeology"
]
}
}
}
}Add to your Zed `settings.json`.
uvx silex-archaeologyRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
Score
39 / 100
Incomplete
- Documentation18/25
- Maintenance19/25
- Trust16/20
- Capability0/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 1 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 0.11.38Latest | Jul 16, 2026 |
| 0.11.37 | Jul 15, 2026 |