Merge pull request #8 from Moonsong-Labs/notlesh/release-analysis-continuation

Release analysis continuation

Author: notlesh

CLAUDE.md

@@ -15,7 +15,9 @@ substrate-mcp/
 ├── CLAUDE.md           # This file - development guidance
 └── src/
     ├── main.rs         # Entry point with tokio async runtime
-    └── server.rs       # MCP server implementation with tool routing
+    ├── server.rs       # MCP server implementation with tool routing
+    └── substrate/      # Substrate client implementation
+        └── client.rs   # RPC client for interacting with nodes
 
 ## Development Commands
 
@@ -63,9 +65,11 @@ This server follows the standard MCP communication pattern:
 ### Current State
 The server currently has:
 - Basic MCP server infrastructure set up
-- One placeholder tool: `say_hello` that returns "Hello, World! From substrate MCP"
-- Server info indicating it's for "Tools and Prompts to work with Substrate based blockchains"
-- Only tools capability enabled (prompts and resources disabled)
+- Several functional tools:
+  - `fetch_and_analyze_release`: Fetches and analyzes Polkadot SDK releases (downloads PRDocs and generates summaries)
+  - `chain_storage_bisect`: Finds storage changes between blocks
+- Server info indicating it's for Substrate-based blockchain development
+- Both tools and resources capabilities enabled
 - Server name: "substrate-mcp" (version 0.1.0)
 
 ### Adding New Tools
@@ -96,6 +100,7 @@ The project can be installed via:
 - Local build: `cargo build --release`
 
 For Claude Code configuration, see README.md for detailed setup instructions.
+
 ## Substrate Integration Guidelines
 
 ### Preferred Crates

Cargo.lock

@@ -9,8 +9,12 @@ indoc = "2.0.6"
 tokio = { version = "1", features = ["full"] }
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
+serde_yaml = "0.9"
+toml = "0.8"
 anyhow = "1"
 reqwest = { version = "0.12", features = ["json"] }
+chrono = { version = "0.4", features = ["serde"] }
+dirs = "5.0"
 
 # For RPC client functionality
 jsonrpsee = { version = "0.20", features = ["http-client", "ws-client", "macros"] }

Cargo.toml

@@ -23,42 +23,6 @@ For the `subxt_execute` tool, install the subxt CLI:
 cargo install subxt-cli
 ```
 
-## Configuration
-
-### RPC Endpoints
-The server uses a `rpc_endpoints.json` configuration file to manage RPC endpoints. This file is automatically created with default endpoints if it doesn't exist.
-
-The configuration includes:
-- **Network name**: Human and LLM-friendly identifier (e.g., "polkadot", "kusama")
-- **URL**: WebSocket endpoint URL
-- **Description**: Detailed description of the network
-
-Example configuration:
-```json
-{
-  "endpoints": [
-    {
-      "name": "polkadot",
-      "url": "wss://rpc.polkadot.io",
-      "description": "Polkadot mainnet - The main Polkadot relay chain"
-    },
-    {
-      "name": "westend",
-      "url": "wss://westend-rpc.polkadot.io",
-      "description": "Westend testnet - Public test network for Polkadot"
-    },
-    {
-      "name": "local",
-      "url": "ws://localhost:9944",
-      "description": "Local development node - Substrate node running on your machine"
-    }
-  ],
-  "default_endpoint": "westend"
-}
-```
-
-You can customize this file to add your own endpoints or modify existing ones.
-
 ## Available Tools
 
 ### Event Querying
@@ -75,7 +39,7 @@ You can customize this file to add your own endpoints or modify existing ones.
 - **`subxt_execute`** - Use subxt CLI to decode and explore Substrate blockchain data. Useful for analyzing chain metadata, generating type-safe Rust code, and understanding runtime APIs.
 
 ### Documentation
-- **`get_polkadot_sdk_release_prdocs`** - Get all documented changes for a given polkadot-sdk release.
+- **`fetch_and_analyze_release`** - Fetches and analyzes a Polkadot SDK release by downloading all PRDoc files and generating analysis summaries (manifest, crate changes, audience breakdown). Files are saved to `~/.substrate-mcp/{project}/releases/{release}/pr-docs/` and the tool returns the path for further exploration.
 
 ## Usage with Claude Code
 

README.md

@@ -1,6 +1,5 @@
 pub mod polkadot_sdk_releases;
 pub mod prompts;
-pub mod public_endpoints;
 pub mod resources;
 pub mod server;
 pub mod substrate;

src/lib.rs

@@ -4,7 +4,6 @@ use tokio::io::{stdin, stdout};
 
 mod polkadot_sdk_releases;
 mod prompts;
-mod public_endpoints;
 mod resources;
 mod server;
 mod substrate;