Initial release v2.0.0 — semantic code intelligence MCP server

16 MCP tools, TF-IDF semantic search, call graph, impact analysis,
dead code detection, circular deps, complexity analysis, path finding.
Supports 13 languages via tree-sitter. Works with Claude Code, Cursor, Windsurf.

Author: NeuralRays

.github/workflows/ci.yml

@@ -0,0 +1,39 @@
+name: CI/CD
+
+on:
+  push:
+    branches: [main]
+    tags: ['v*']
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [16, 18, 20, 22]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+      - run: npm install
+      - run: npm run build
+      - run: npm test
+
+  publish:
+    needs: test
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: 'https://registry.npmjs.org'
+      - run: npm install
+      - run: npm run build
+      - run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -0,0 +1,26 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+
+# CodeXRay local index
+.codexray/
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Logs
+*.log
+npm-debug.log*
+
+# Environment
+.env
+.env.local

.npmrc

@@ -0,0 +1 @@
+legacy-peer-deps=true

CLAUDE.md

@@ -0,0 +1,24 @@
+# CodeXRay — AI Agent Instructions
+
+This project uses CodeXRay for semantic code intelligence. Use these MCP tools instead of scanning files.
+
+## Workflow
+
+1. **codexray_overview** → project structure, languages, key symbols (START HERE)
+2. **codexray_context** → task-relevant code + snippets (replaces 5-10 file reads)
+3. **codexray_search** → find symbols by name/keyword (faster than grep/glob)
+4. **codexray_semantic** → find code by meaning ("authentication" → login, validateToken)
+5. **codexray_node** → detailed symbol info + full source code
+6. **codexray_callers/callees** → trace call relationships
+7. **codexray_deps** → full dependency tree of any symbol
+8. **codexray_path** → shortest connection between two symbols
+9. **codexray_impact** → blast radius analysis before changes
+10. **codexray_hotspots** → most critical/connected symbols
+11. **codexray_deadcode** → find unused functions/classes
+12. **codexray_circular** → detect circular dependencies
+13. **codexray_complexity** → find high-complexity functions
+14. **codexray_files** → browse file structure with stats
+15. **codexray_status** → index health check
+
+## Key Principle
+Query the graph instead of scanning files. One `codexray_context` call replaces 5-10 file reads.