io.github.CSCSoftware/aidex
NPM · AIDEX-MCP · SCANNED SEP 24
Persistent code indexing for AI assistants. 50x less context than grep. 11 languages.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security92
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- Runs a script at install time (postinstall) that we could not recognise. It may be perfectly ordinary, but we do not read the published tarball, so we cannot say what it does. View diagnostics → Partial
- 65 of 212 dependencies flagged as unhealthy (2 deprecated). View diagnostics → Partial
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 49 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability81
- AI-judged instruction clarity (excellent).Pass
- Tool/resource definitions use about 2034 tokens (~101/item across 20 items; 20 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management80
- Stability observed for 24 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Tool Safety75
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 0 of 2 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "aidex_remove" implies "remove" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Fail
- An AI judge read all 20 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
How do I install the io.github.CSCSoftware/aidex MCP server?
io.github.CSCSoftware/aidex runs locally as an npm package, launched with npx -y aidex-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · aidex-mcp
claude mcp add cscsoftware-aidex -- npx -y aidex-mcp
{
"mcpServers": {
"cscsoftware-aidex": {
"command": "npx",
"args": [
"-y",
"aidex-mcp"
]
}
}
} {
"servers": {
"cscsoftware-aidex": {
"command": "npx",
"args": [
"-y",
"aidex-mcp"
]
}
}
} codex mcp add cscsoftware-aidex -- npx -y aidex-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"cscsoftware-aidex": {
"type": "local",
"command": [
"npx",
"-y",
"aidex-mcp"
],
"enabled": true
}
}
} openclaw mcp add cscsoftware-aidex --command npx --arg -y --arg aidex-mcp
mcp_servers:
cscsoftware-aidex:
command: "npx"
args: ["-y", "aidex-mcp"] {
"McpServers": {
"cscsoftware-aidex": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"aidex-mcp"
]
}
}
} assistant mcp add cscsoftware-aidex -t stdio -c npx -a -y aidex-mcp
{
"mcpServers": {
"cscsoftware-aidex": {
"command": "npx",
"args": [
"-y",
"aidex-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 24 Sept 26 −3
- Stability: pass → 0.80 functional
- 23 Sept 26 +1
- Stability: 0.97 → pass security
- Security disclosure: unverified → fail ▼ functional
- 22 Sept 26 0
- Security disclosure: fail → unverified ▼ functional
- 21 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 90 to 93. That category is still filling its 30-day observation window: 27 days of observed history at the previous scan, 28 at this one. The score rises as the window fills, whether or not the server changes.
- 19 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 83 to 87. That category is still filling its 30-day observation window: 25 days of observed history at the previous scan, 26 at this one. The score rises as the window fills, whether or not the server changes.
- 18 Sept 26 −3
- Stability: pass → 0.83 functional
- 17 Sept 26 +1
- Stability: 0.97 → pass security
- 15 Sept 26 +2
- CVE-2026-82562 no longer affects this package ▲ security
- CVE-2026-82417 no longer affects this package ▲ security
- Known CVEs: fail → pass ▲ security
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 24 Sept 2026 · Analysed npm/aidex-mcp@1.8.0
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Background: How many MCP packages publish verified provenance →
Install scripts 1 script
| Hook | Tier | Command |
|---|---|---|
| postinstall | unreviewed | node scripts/postinstall.mjs |
Background: Why install scripts are a supply-chain risk →
Dependencies 212 packages
| Packages resolved | 212 |
|---|---|
| Deprecated | 2 |
| Stale | 63 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
aidex_describe ~90
Add or update a section in the project summary (summary.md). Use to document project purpose, architecture, key concepts, or patterns.
| Name | Type | Req | Description |
|---|---|---|---|
| content | string | yes | Content to add to the section |
| path | string | yes | Path to project with .aidex directory |
| replace | boolean | – | Replace existing section content (default: append) |
| section | string | yes | Section to update |
No output schema declared.
No examples provided.
aidex_files ~151
List all files and directories in the indexed project. Returns the complete project structure with file types (code, config, doc, asset, test, other) and whether each file is indexed for code search. Use modified_since to find files changed in this session.
| Name | Type | Req | Description |
|---|---|---|---|
| modified_since | string | – | Only files indexed after this time. Supports: "2h", "30m", "1d", "1w", or ISO date. Use to find files changed this session. |
| path | string | yes | Path to project with .aidex directory |
| pattern | string | – | Glob pattern to filter files (e.g., "src/**/*.ts") |
| type | string | – | Filter by file type |
No output schema declared.
No examples provided.
aidex_init ~88
Initialize AiDex indexing for a project. Scans all source files and builds a searchable index of identifiers, methods, types, and signatures.
| Name | Type | Req | Description |
|---|---|---|---|
| exclude | array | – | Additional glob patterns to exclude (e.g., ["**/test/**"]) |
| name | string | – | Optional project name (defaults to directory name) |
| path | string | yes | Absolute path to the project directory to index |
No output schema declared.
No examples provided.
aidex_link ~72
Link a dependency project to enable cross-project queries. The dependency must have its own .aidex index.
| Name | Type | Req | Description |
|---|---|---|---|
| dependency | string | yes | Path to dependency project to link |
| name | string | – | Optional display name for the dependency |
| path | string | yes | Path to current project with .aidex directory |
No output schema declared.
No examples provided.
aidex_links ~30
List all linked dependency projects.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | Path to project with .aidex directory |
No output schema declared.
No examples provided.
aidex_note ~130
Read or write a session note for the project. Use this to leave reminders for the next session (e.g., "Test the glob fix", "Refactor X"). Notes persist in the AiDex database and are shown when querying the project.
| Name | Type | Req | Description |
|---|---|---|---|
| append | boolean | – | If true, appends to existing note instead of replacing (default: false) |
| clear | boolean | – | If true, clears the note (default: false) |
| note | string | – | Note to save. If omitted, reads the current note. |
| path | string | yes | Path to project with .aidex directory |
No output schema declared.
No examples provided.
aidex_query ~246
Search for terms/identifiers in the AiDex index. Returns file locations where the term appears. PREFERRED over Grep/Glob for code searches when .aidex/ exists - faster and more precise. Use this instead of grep for finding functions, classes, variables by name.
| Name | Type | Req | Description |
|---|---|---|---|
| file_filter | string | – | Glob pattern to filter files (e.g., "src/commands/**") |
| limit | number | – | Maximum number of results (default: 100) |
| mode | string | – | Search mode: exact match, contains, or starts_with (default: exact) |
| modified_before | string | – | Only include lines modified before this time. Same format as modified_since |
| modified_since | string | – | Only include lines modified after this time. Supports: "2h" (hours), "30m" (minutes), "1d" (days), "1w" (weeks), or ISO date string |
| path | string | yes | Path to project with .aidex directory |
| term | string | yes | The term to search for |
| type_filter | array | – | Filter by line type: code, comment, method, struct, property |
No output schema declared.
No examples provided.
aidex_remove ~68
Remove a file from the AiDex index. Use when a file has been deleted from the project.
| Name | Type | Req | Description |
|---|---|---|---|
| file | string | yes | Relative path to the file to remove (e.g., "src/OldFile.cs") |
| path | string | yes | Path to project with .aidex directory |
No output schema declared.
No examples provided.
aidex_scan ~85
Scan a directory tree to find all projects with AiDex indexes (.aidex directories). Use this to discover which projects are already indexed before using Grep/Glob - indexed projects should use aidex_query instead.
| Name | Type | Req | Description |
|---|---|---|---|
| max_depth | number | – | Maximum directory depth to scan (default: 10) |
| path | string | yes | Root path to scan for .aidex directories |
No output schema declared.
No examples provided.
aidex_session ~88
Start or check an AiDex session. Call this at the beginning of a new chat session to: (1) detect files changed externally since last session, (2) auto-reindex modified files, (3) get session note and last session times. Returns info for "What did we do last session?" queries.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | Path to project with .aidex directory |
No output schema declared.
No examples provided.
aidex_signature ~102
Get the signature of a single file: header comments, types (classes/structs/interfaces), and method prototypes. Use this INSTEAD of reading entire files when you only need to know what methods/classes exist. Much faster than Read tool for understanding file structure.
| Name | Type | Req | Description |
|---|---|---|---|
| file | string | yes | Relative path to the file within the project (e.g., "src/Core/Engine.cs") |
| path | string | yes | Path to project with .aidex directory |
No output schema declared.
No examples provided.
aidex_signatures ~109
Get signatures for multiple files at once using glob pattern or file list. Returns types and method prototypes. Use INSTEAD of reading multiple files when exploring codebase structure. Much more efficient than multiple Read calls.
| Name | Type | Req | Description |
|---|---|---|---|
| files | array | – | Explicit list of relative file paths (alternative to pattern) |
| path | string | yes | Path to project with .aidex directory |
| pattern | string | – | Glob pattern to match files (e.g., "src/Core/**/*.cs", "**/*.ts") |
No output schema declared.
No examples provided.
aidex_status ~45
Get AiDex server status and statistics for an indexed project
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | – | Path to project with .aidex directory (optional, shows server status if not provided) |
No output schema declared.
No examples provided.
aidex_summary ~50
Get project summary including auto-detected entry points, main types, and languages. Also returns content from summary.md if it exists.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | Path to project with .aidex directory |
No output schema declared.
No examples provided.
aidex_task ~253
Manage a single task in the project backlog. Actions: create (new task), read (get task + log), update (change fields), delete, log (add history note). Tasks persist in the AiDex database. Completed tasks are preserved as documentation.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | Action to perform on the task |
| description | string | – | Task description (optional details) |
| id | number | – | Task ID (required for read/update/delete/log) |
| note | string | – | Log note text (required for log action) |
| path | string | yes | Path to project with .aidex directory |
| priority | number | – | Priority: 1=high, 2=medium (default), 3=low |
| sort_order | number | – | Sort order within same priority (lower = first, default: 0) |
| source | string | – | Where the task came from (freetext, e.g., "code review of parser.ts:142") |
| status | string | – | Task status (default: backlog) |
| tags | string | – | Comma-separated tags (e.g., "bug, viewer, parser") |
| title | string | – | Task title (required for create) |
No output schema declared.
No examples provided.
aidex_tasks ~106
List and filter tasks in the project backlog. Returns tasks grouped by status (active, backlog, done, cancelled) and sorted by priority. Use to get an overview of all open and completed work.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | Path to project with .aidex directory |
| priority | number | – | Filter by priority |
| status | string | – | Filter by status (default: show all) |
| tag | string | – | Filter by tag (matches any task containing this tag) |
No output schema declared.
No examples provided.
aidex_tree ~94
Get the indexed file tree. Optionally filter by subdirectory, limit depth, or include statistics per file.
| Name | Type | Req | Description |
|---|---|---|---|
| depth | number | – | Maximum depth to traverse (default: unlimited) |
| include_stats | boolean | – | Include item/method/type counts per file |
| path | string | yes | Path to project with .aidex directory |
| subpath | string | – | Subdirectory to list (default: project root) |
No output schema declared.
No examples provided.
aidex_unlink ~45
Remove a linked dependency project.
| Name | Type | Req | Description |
|---|---|---|---|
| dependency | string | yes | Path to dependency project to unlink |
| path | string | yes | Path to current project with .aidex directory |
No output schema declared.
No examples provided.
aidex_update ~91
Re-index a single file. Use after editing a file to update the AiDex index. If the file is new, it will be added to the index. If unchanged (same hash), no update is performed.
| Name | Type | Req | Description |
|---|---|---|---|
| file | string | yes | Relative path to the file to update (e.g., "src/Core/Engine.cs") |
| path | string | yes | Path to project with .aidex directory |
No output schema declared.
No examples provided.
aidex_viewer ~91
Open an interactive project tree viewer in the browser. Shows the indexed file structure with clickable nodes - click on a file to see its signature (header comments, types, methods). Uses a local HTTP server with WebSocket for live updates.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | – | Action to perform: open (default) or close the viewer |
| path | string | yes | Path to project with .aidex directory |
No output schema declared.
No examples provided.
What is the io.github.CSCSoftware/aidex MCP server?
io.github.CSCSoftware/aidex is an MCP server listed in the public MCP registry as io.github.CSCSoftware/aidex. Persistent code indexing for AI assistants. 50x less context than grep. 11 languages. This page covers its npm package (aidex-mcp).
Is the io.github.CSCSoftware/aidex MCP server safe to use?
io.github.CSCSoftware/aidex scores 79 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 24 September 2026. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.CSCSoftware/aidex MCP server expose?
io.github.CSCSoftware/aidex exposes 20 tools: aidex_init, aidex_query, aidex_status, aidex_signature, aidex_signatures, and 15 more. Their descriptions and schemas cost roughly 2,034 tokens of context every time the server is loaded.
Is the io.github.CSCSoftware/aidex MCP server still maintained?
io.github.CSCSoftware/aidex is still listed as active in the MCP registry. We last reached this channel on 24 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the io.github.CSCSoftware/aidex MCP server under?
io.github.CSCSoftware/aidex declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.