sol-mcp 0.2.0__py3-none-any.whl

sol_mcp-0.2.0.dist-info/METADATA

@@ -0,0 +1,218 @@
+Metadata-Version: 2.4
+Name: sol-mcp
+Version: 0.2.0
+Summary: RAG-powered MCP server for Solana runtime and SIMDs
+Project-URL: Homepage, https://github.com/be-nvy/solana-mcp
+Project-URL: Documentation, https://github.com/be-nvy/solana-mcp#readme
+Project-URL: Repository, https://github.com/be-nvy/solana-mcp.git
+Project-URL: Issues, https://github.com/be-nvy/solana-mcp/issues
+Author: be.nvy
+License-Expression: MIT
+Keywords: blockchain,mcp,rag,runtime,search,simd,solana
+Classifier: Development Status :: 4 - Beta
+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: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Requires-Dist: click>=8.0.0
+Requires-Dist: gitpython>=3.1.0
+Requires-Dist: lancedb>=0.4.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: sentence-transformers>=2.2.0
+Requires-Dist: tree-sitter-c>=0.20.0
+Requires-Dist: tree-sitter-rust>=0.20.0
+Requires-Dist: tree-sitter>=0.20.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: voyage
+Requires-Dist: voyageai>=0.2.0; extra == 'voyage'
+Description-Content-Type: text/markdown
+
+# solana-mcp
+
+RAG-powered MCP server for Solana runtime, SIMDs, and validator client source code.
+
+## What It Does
+
+Indexes and searches across:
+- **Agave** - Reference Rust validator (Anza)
+- **Jito-Agave** - MEV-enabled fork (~70% of mainnet stake)
+- **Jito Programs** - On-chain tip distribution and MEV programs
+- **Firedancer** - Jump's C implementation (~22% with Frankendancer)
+- **SIMDs** - Solana Improvement Documents
+- **Alpenglow** - Future consensus protocol (not yet live)
+
+## Quick Start
+
+```bash
+# Install
+pip install -e .
+
+# Full build (download repos + compile + index)
+solana-mcp build
+
+# Or step by step
+solana-mcp download   # Clone repositories
+solana-mcp compile    # Extract code to JSON
+solana-mcp index      # Build vector embeddings
+```
+
+## CLI Commands
+
+```bash
+# Build pipeline
+solana-mcp build      # Full pipeline
+solana-mcp download   # Clone repos (agave, jito-solana, firedancer, SIMDs, alpenglow)
+solana-mcp compile    # Parse Rust/C code into JSON
+solana-mcp index      # Build LanceDB vector index
+
+# Search
+solana-mcp search "stake delegation"
+solana-mcp search "tower bft" --type rust
+solana-mcp search "leader schedule" --limit 10
+
+# Lookup
+solana-mcp constant LAMPORTS_PER_SOL
+solana-mcp function process_vote
+
+# Status
+solana-mcp status     # Show what's downloaded/compiled/indexed
+```
+
+## MCP Tools
+
+When running as an MCP server, these tools are available:
+
+| Tool | Purpose |
+|------|---------|
+| `sol_search` | Semantic search across all indexed content |
+| `sol_search_simd` | Search SIMDs specifically |
+| `sol_grep_constant` | Fast constant lookup |
+| `sol_analyze_function` | Get function source code |
+| `sol_get_current_version` | Current mainnet version (v2.1) |
+| `sol_list_versions` | Version history with features |
+| `sol_get_consensus_status` | TowerBFT (current) vs Alpenglow (future) |
+| `sol_list_feature_gates` | Feature gate activations |
+| `sol_list_clients` | Validator client implementations |
+| `sol_get_client` | Details on specific client |
+| `sol_get_client_diversity` | Stake distribution across clients |
+| `sol_expert_guidance` | Curated guidance on topics |
+
+## Validator Clients
+
+Solana validator clients indexed:
+
+| Client | Language | Notes |
+|--------|----------|-------|
+| Jito-Agave | Rust | MEV-enabled fork |
+| Frankendancer | C+Rust | Firedancer networking + Agave runtime |
+| Agave | Rust | Reference implementation (Anza) |
+| Firedancer | C | Full independent implementation (Jump) |
+
+For current client diversity statistics, see [validators.app](https://www.validators.app/cluster-stats).
+
+## Project Structure
+
+```
+src/solana_mcp/
+├── server.py           # MCP server with all tools
+├── cli.py              # CLI commands
+├── versions.py         # Version/client/consensus tracking
+├── indexer/
+│   ├── downloader.py   # Git clone with sparse checkout
+│   ├── compiler.py     # Rust + C parsing (tree-sitter)
+│   ├── chunker.py      # Code/markdown chunking
+│   └── embedder.py     # Embeddings + LanceDB
+└── expert/
+    └── guidance.py     # Curated expert knowledge
+```
+
+## Data Location
+
+```
+~/.solana-mcp/
+├── agave/              # Reference client source
+├── jito-solana/        # MEV fork source
+├── jito-programs/      # On-chain MEV programs
+├── firedancer/         # Jump's C implementation
+├── solana-improvement-documents/
+├── alpenglow/          # Future consensus
+├── compiled/           # Extracted JSON
+│   ├── agave/
+│   ├── jito-solana/
+│   ├── jito-programs/
+│   └── firedancer/
+└── lancedb/            # Vector index
+```
+
+## Expert Guidance Topics
+
+The `sol_expert_guidance` tool provides curated knowledge on:
+
+**Staking & Consensus:**
+- `staking` - Delegation, warmup/cooldown, rewards
+- `voting` - Vote accounts, TowerBFT voting
+- `slashing` - Current lack of slashing, future plans
+- `towerbft` - Current consensus mechanism
+- `consensus` - PoH + TowerBFT relationship
+- `alpenglow` - Future consensus (~150ms finality)
+- `poh` - Proof of History (ordering, not consensus)
+
+**Runtime & Architecture:**
+- `accounts` - Account model, rent, ownership
+- `svm` - Solana Virtual Machine
+- `turbine` - Block propagation
+- `leader_schedule` - Slot assignment
+- `epochs` - 432,000 slots, ~2-3 days
+
+**MEV (Jito):**
+- `mev` - MEV on Solana overview
+- `jito` - Jito infrastructure and architecture
+- `bundles` - Atomic transaction bundles
+- `tips` - Tip distribution to validators/stakers
+
+## Solana vs Ethereum
+
+| Aspect | Ethereum | Solana |
+|--------|----------|--------|
+| Spec format | Markdown + Python | Rust implementation |
+| Slashing | Yes (3 penalties) | No (indirect penalties only) |
+| Finality | ~13 min | ~12.8s → 150ms (Alpenglow) |
+| Consensus | Casper FFG | TowerBFT → Alpenglow |
+
+## Development
+
+```bash
+# Install with dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Lint
+ruff check src/
+```
+
+## Differences from Official Solana MCP
+
+The official [mcp.solana.com](https://mcp.solana.com) is documentation-focused.
+
+This implementation:
+- Indexes actual **source code** from multiple clients
+- Parses **Rust and C** with tree-sitter
+- Tracks **client diversity** and stake distribution
+- Includes **expert guidance** from protocol research
+- Provides **constant/function lookup** with full source
+
+## License
+
+MIT

sol_mcp-0.2.0.dist-info/RECORD

@@ -0,0 +1,20 @@
+solana_mcp/__init__.py,sha256=HlNT4RJvbDFDO_Jpczsuj4wfG6LQB3_C_vmi6GQD8M8,95
+solana_mcp/cli.py,sha256=4Xbp6uhLtiD9ya4ml7M3CHLr7hQpLIvUgZswDmudxG4,17659
+solana_mcp/config.py,sha256=-y_uYIQFNwiztZpAeoVaG7_ibekD41xMuBioIj9q1bc,9775
+solana_mcp/logging.py,sha256=y9NJOIjopo5VUpCxD92TDt2ANtlNn_0t0jJdG44KV18,2033
+solana_mcp/models.py,sha256=Nh9kduT_NdTfzbOG9QrgNp2382u5Gw8rYUcz7RHlKZg,1810
+solana_mcp/server.py,sha256=xXerV5lz3mLEuQpypOrsdE75CGg6a_M6-0unFuXWSEw,24027
+solana_mcp/versions.py,sha256=fSxGMOubBWVaxkkrdmAklC-Jvn62kcbp1rfSjSpW6so,13172
+solana_mcp/expert/__init__.py,sha256=VPZ0bjBssqQGTp-OxTDM1iiNuugGHMn4iKfBBm3KBn8,197
+solana_mcp/expert/guidance.py,sha256=cW_JGdQL_NPSPrpfwTnMmSBXg-ZOUy3bfy34C6AwKBw,21663
+solana_mcp/indexer/__init__.py,sha256=CBizqn3uCQL2An0a6cS7mK-bkaQzSrc7C4HsP-BWy8M,263
+solana_mcp/indexer/chunker.py,sha256=2Wc5haGNNOsEJgBPpuEeOoQeMWQ99svBOdKnm6tBJmY,14387
+solana_mcp/indexer/compiler.py,sha256=Vg9j2NU_DAkdG6Ill7qcLmqeOB9Y9F6ct_7zYJi7qvY,37568
+solana_mcp/indexer/downloader.py,sha256=8-Pl-jfsyWVVI1_93RrdHN21ppC5gpWt27J-3aOJ4fo,9374
+solana_mcp/indexer/embedder.py,sha256=PqHRfvqByeof8Juc2TgsuCIFcxtZkuQ_TlqlZGk42Oo,24465
+solana_mcp/indexer/manifest.py,sha256=DfK4Ddb4n-8IgoCVlzeTvCiwUCKpmscMLr0EMreJ8Sw,12663
+solana_mcp/tools/__init__.py,sha256=ODg8b6g5JUklg52mVaQdYUZq8MwsSjeXPhr5hndlgUk,28
+sol_mcp-0.2.0.dist-info/METADATA,sha256=hu5bMafrdb8AHhlT95GKqI7cwH-AdBO3zSbz3gHFONg,6970
+sol_mcp-0.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+sol_mcp-0.2.0.dist-info/entry_points.txt,sha256=Q3evUFnZQQXnhoKIIhduDX2jymUGfkyt_CDCoNF_wyk,83
+sol_mcp-0.2.0.dist-info/RECORD,,

sol_mcp-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

sol_mcp-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+sol-mcp = solana_mcp.server:run
+solana-mcp = solana_mcp.cli:main

solana_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""Solana MCP - RAG-powered MCP server for Solana runtime and SIMDs."""
+
+__version__ = "0.1.0"