intermcp 0.2.0 → 0.3.0

package/README.md

@@ -10,30 +10,38 @@
 ```
 
 ### Ultra-Fast, Safe Model Context Protocol (MCP) Engine & Multiplexing Hub in Pure Rust
-**Sub-millisecond dispatch • 457,000+ ops/sec* • < 3.8 MB RAM • SafeFS Sandboxing • 1-Click Multi-IDE Setup**
-
-*Originally engineered for low-latency AI tool execution on the **Interlayer** blockchain; 100% open-source for the global developer ecosystem.*
-
-[![Crates.io](https://img.shields.io/badge/crates.io-v0.2.0-orange.svg?style=for-the-badge&logo=rust)](https://crates.io/crates/intermcp)
-[![npm](https://img.shields.io/badge/npm-v0.2.0-CB3837.svg?style=for-the-badge&logo=npm)](https://www.npmjs.com/package/intermcp)
-[![License](https://img.shields.io/badge/license-MIT-blue.svg?style=for-the-badge)](LICENSE)
-[![CI Status](https://img.shields.io/badge/CI-passing-brightgreen.svg?style=for-the-badge&logo=githubactions)](https://github.com/Bharathcoorg/intermcp)
-[![Memory](https://img.shields.io/badge/RAM-<3.8MB-purple.svg?style=for-the-badge)](https://github.com/Bharathcoorg/intermcp)
-[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-green.svg?style=for-the-badge)](CONTRIBUTING.md)
-
-[Quickstart](#-1-click-installation--setup) • [Benchmarks](#-benchmarks) • [Key Features](#-key-features) • [Rust](#-rust-sdk-usage) • [TypeScript](#-typescript--node-sdk) • [Python](#-python-client--agent-usage) • [Go](#-go-client-usage) • [PHP](#-php-client-usage) • [Guides](#-developer-guides) • [Security](#-security--vulnerability-reporting)
+**Sub-millisecond dispatch • pending benchmark • SafeFS Sandboxing • 1-Click Multi-IDE Setup**
+
+*Ultra-fast, safe Model Context Protocol (MCP) engine and multiplexing hub in pure Rust, built for Interlayer Blockchain and open for all.*
+
+<p align="center">
+  <a href="https://crates.io/crates/intermcp"><img src="https://img.shields.io/crates/v/intermcp.svg?style=for-the-badge&logo=rust" alt="Crates.io" /></a>
+  <a href="https://www.npmjs.com/package/intermcp"><img src="https://img.shields.io/npm/v/intermcp.svg?style=for-the-badge&logo=npm" alt="npm" /></a>
+  <a href="https://pypi.org/project/intermcp/"><img src="https://img.shields.io/pypi/v/intermcp.svg?style=for-the-badge&logo=pypi" alt="PyPI" /></a>
+  <a href="https://github.com/Bharathcoorg/intermcp/releases/tag/v0.3.0"><img src="https://img.shields.io/github/v/release/Bharathcoorg/intermcp?style=for-the-badge&logo=github" alt="GitHub release" /></a>
+  <a href="https://github.com/Bharathcoorg/intermcp/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/Bharathcoorg/intermcp/ci.yml?branch=main&style=for-the-badge&logo=githubactions" alt="CI Status" /></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg?style=for-the-badge" alt="License: MIT" /></a>
+</p>
+
+| Platform / Ecosystem | Package Registry | Install Command | Links / Badges |
+| :--- | :--- | :--- | :--- |
+| **Rust (CLI Binary)** | **crates.io** | `cargo install intermcp` | [![crates.io](https://img.shields.io/crates/v/intermcp.svg)](https://crates.io/crates/intermcp) • [crates.io/crates/intermcp](https://crates.io/crates/intermcp) |
+| **Rust (Library SDK)** | **crates.io** | `cargo add intermcp` | [docs.rs/intermcp](https://docs.rs/intermcp) |
+| **JavaScript / TypeScript** | **npm** | `npm install intermcp` | [![npm](https://img.shields.io/npm/v/intermcp.svg)](https://www.npmjs.com/package/intermcp) • [npmjs.com/package/intermcp](https://www.npmjs.com/package/intermcp) |
+| **Python** | **PyPI** | `pip install intermcp` | [![PyPI](https://img.shields.io/pypi/v/intermcp.svg)](https://pypi.org/project/intermcp/) • [pypi.org/project/intermcp](https://pypi.org/project/intermcp) |
+| **Go** | **Go Modules** | `go get github.com/Bharathcoorg/intermcp/go/intermcp@v0.3.0` | [pkg.go.dev/github.com/Bharathcoorg/intermcp/go/intermcp](https://pkg.go.dev/github.com/Bharathcoorg/intermcp/go/intermcp) |
+| **PHP** | **Packagist** | `composer require bharathcoorg/intermcp` | [packagist.org/packages/bharathcoorg/intermcp](https://packagist.org/packages/bharathcoorg/intermcp) |
+| **Standalone Binaries** | **GitHub Releases** | Prebuilt binaries for Linux, macOS (ARM & Intel), Windows | [GitHub Releases](https://github.com/Bharathcoorg/intermcp/releases) |
 
 ---
 
-</div>
-
 ## 💡 Overview
 
 The **Model Context Protocol (MCP)** standardizes how language models (Claude Desktop, Cursor, Windsurf, Zed) interface with external developer tools, file systems, and databases.
 
 **`InterMCP`** is a minimal-dependency, pure Rust implementation of the MCP specification (2024-11-05), engineered for high-throughput, low-latency, and memory-constrained environments:
 - **Low-Latency Routing**: sub-millisecond in-process dispatch (see bench).
-- **Minimal Footprint**: Operates in under 3.8 MB of resident memory (RSS).
+- **Minimal Footprint**: Operates with minimal resident memory (RSS; pending benchmark).
 - **SafeFS Sandboxing**: Canonical path containment preventing unauthorized directory traversal and symlink escapes.
 - **Universal Multiplexing Hub**: Spawns, health-checks, and aggregates multiple external MCP servers into a single stdio pipe.
 - **Dynamic Tool Discovery**: Reduces LLM context token consumption by injecting tool schemas on demand.
@@ -74,10 +82,18 @@ npx intermcp serve
 
 #### Option B: Via Cargo (Rust Developers)
 ```bash
+# Install the standalone binary globally
 cargo install intermcp
+
+# Or install precompiled binary instantly without compilation:
+cargo binstall intermcp
+
+# Run 1-click configuration
 intermcp setup
 ```
 
+> 💡 **Compilation Note**: `cargo install` compiles `ring` from source, which requires a standard C compiler (`gcc`, `clang`, or MSVC). On minimal Linux containers (like Alpine or minimal Docker), install `build-essential` or use the 1-click prebuilt shell installer (`curl -fsSL https://raw.githubusercontent.com/Bharathcoorg/intermcp/main/install.sh | sh`).
+
 ---
 
 ## 🎯 Supported IDEs & AI Environments
@@ -106,9 +122,9 @@ Micro-benchmarks conducted on an AMD Ryzen 9 / Apple Silicon system processing 5
 | Metric | Reference Node.js SDK (`@modelcontextprotocol/sdk`) | Reference Python SDK (`mcp`) | **InterMCP (Pure Rust)** |
 | :--- | :---: | :---: | :---: |
 | **Cold Boot Latency** | 420 ms | 680 ms | **0.4 ms** |
-| **Memory Footprint (RSS)** | 162 MB | 114 MB | **< 3.8 MB** |
+| **Memory Footprint (RSS)** | 162 MB | 114 MB | **pending benchmark** |
 | **Average Dispatch Latency** | 45.0 ms | 62.0 ms | **sub-millisecond (< 5 µs in-process)** |
-| **Throughput (Single Core)** | 1,420 ops/s | 890 ops/s | **457,042 ops/s\*** |
+| **Throughput (Single Core)** | 1,420 ops/s | 890 ops/s | **pending benchmark** |
 | **Runtime Dependencies** | Node.js + npm dependencies | Python 3.10+ + virtualenv | **None (Static Binary)** |
 
 Reproduce locally with:
@@ -173,8 +189,8 @@ Any environment variables containing sensitive keys (`API_KEY`, `SECRET`, `TOKEN
 ### 7. Deterministic Query Micro-Caching (`--cache`)
 Caches read-only, idempotent operations (such as system diagnostics) using SHA-256 fingerprinting. Read/write filesystem tools remain uncached to guarantee fresh data.
 
-### 8. ADR 001: Signed Execution Receipts & Provenance (`--receipts`)
-Generates tamper-evident cryptographic receipts for every tool execution using RFC 8785 JSON Canonicalization Scheme (JCS) and HMAC-SHA256 digital signatures. Authenticate offline with:
+### 8. ADR 001: HMAC-Authenticated Execution Receipts & Provenance (`--receipts`)
+Generates tamper-evident cryptographic receipts for every tool execution using RFC 8785 JSON Canonicalization Scheme (JCS) and HMAC-SHA256 authentication codes. Authenticate offline with:
 ```bash
 intermcp verify-receipts audit.receipts.json --key secret-key
 ```
@@ -222,7 +238,7 @@ max_calls_per_minute = 60
 ```
 
 ### 14. Dynamic Data-Flow Taint Tracking (`src/taint.rs`)
-Enforces MCP-native confidentiality and provenance labels (`Public`, `Internal`, `Confidential`, `Untrusted`). Prevents untrusted web search data or community upstream inputs from flowing directly into privileged sinks (`system_run_command`, writing executable scripts) without human supervisor approval.
+Enforces MCP-native confidentiality and provenance labels (`Public`, `Internal`, `Confidential`, `Untrusted`). Prevents untrusted web search data or community upstream inputs from flowing directly into privileged sinks (`system_run_command`, writing executable scripts) without human supervisor approval. Note: Taint propagation across unstructured text transformations is cooperative and tracked on structured JSON envelopes.
 
 ### 15. WebAssembly Module Inspector (`src/wasm.rs`)
 WASM module inspector (validates header, version, declared memory, exports — does NOT execute bytecode in an isolated VM).
@@ -239,6 +255,8 @@ Implements the **2024-11-05 Model Context Protocol specification**:
 - `system_info`, `system_run_command`
 - `intermcp_search_tools` (when `--smart-discovery` is enabled)
 
+> ⚠️ **Disclaimer**: The Gravity DEX tools in this release return hardcoded placeholder data. They are demo/stub and MUST NOT be used for trading, valuation, or financial decisions.
+
 ### Resources (`resources/list`, `resources/read`)
 - `system://diagnostics`: Host architecture, CPU, and process memory telemetry.
 
@@ -264,7 +282,7 @@ use serde_json::json;
 
 #[tokio::main]
 async fn main() -> Result<()> {
-    let mut server = Server::new("custom-server", "0.2.0");
+    let mut server = Server::new("custom-server", "0.3.0");
 
     server.add_tool(Box::new(SimpleTool::new(
         "calculate_hash",

package/index.js

@@ -1,4 +1,4 @@
-/** InterMCP Node.js / TypeScript SDK v0.2.0 */
+/** InterMCP Node.js / TypeScript SDK v0.3.0 */
 const { spawn } = require("child_process");
 const readline = require("readline");
 const path = require("path");
@@ -6,6 +6,7 @@ const path = require("path");
 class InterMcpClient {
   constructor(options = {}) {
     this.plugin = options.plugin || null;
+    this.binaryPath = options.binaryPath || null;
     this.proc = null;
     this.rl = null;
     this.requestId = 0;
@@ -15,15 +16,26 @@ class InterMcpClient {
   async start() {
     const isWin = process.platform === "win32";
     const binaryName = isWin ? "intermcp.exe" : "intermcp";
-    const binPath = path.join(__dirname, "target", "release", binaryName);
+    const defaultRelease = path.join(__dirname, "target", "release", binaryName);
+    const defaultDebug = path.join(__dirname, "target", "debug", binaryName);
+
+    let cmd = this.binaryPath;
+    if (!cmd) {
+      if (require("fs").existsSync(defaultRelease)) {
+        cmd = defaultRelease;
+      } else if (require("fs").existsSync(defaultDebug)) {
+        cmd = defaultDebug;
+      } else {
+        cmd = "cargo";
+      }
+    }
 
-    const cmd = require("fs").existsSync(binPath) ? binPath : "cargo";
     const args = cmd === "cargo"
       ? ["run", "--manifest-path", path.join(__dirname, "Cargo.toml"), "--", "serve", ...(this.plugin ? ["--plugin", this.plugin] : [])]
       : ["serve", ...(this.plugin ? ["--plugin", this.plugin] : [])];
 
     this.proc = spawn(cmd, args, {
-      stdio: ["pipe", "pipe", "inherit"],
+      stdio: ["pipe", "pipe", "pipe"],
     });
 
     this.rl = readline.createInterface({
@@ -51,7 +63,7 @@ class InterMcpClient {
     // Handshake
     await this.request("initialize", {
       protocolVersion: "2024-11-05",
-      clientInfo: { name: "intermcp-node-client", version: "0.2.0" },
+      clientInfo: { name: "intermcp-node-client", version: "0.3.0" },
     });
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "intermcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Ultra-fast, safe Model Context Protocol (MCP) engine and multiplexing hub in pure Rust, built for Interlayer Blockchain and open for all",
   "main": "index.js",
   "types": "index.d.ts",
@@ -22,12 +22,32 @@
   "keywords": [
     "mcp",
     "model-context-protocol",
+    "mcp-server",
+    "mcp-client",
+    "mcp-runtime",
+    "mcp-hub",
     "ai",
+    "ai-agents",
+    "agentic-ai",
+    "autonomous-agents",
+    "function-calling",
+    "tool-calling",
+    "blockchain",
+    "interlayer",
+    "interlayer-blockchain",
+    "web3",
+    "decentralized-ai",
     "claude",
+    "claude-desktop",
     "cursor",
+    "windsurf",
+    "cline",
     "llm",
+    "llm-tools",
     "rust",
-    "agent",
+    "systems-programming",
+    "safefs",
+    "zero-trust",
     "developer-tools"
   ],
   "author": "Bharath B R <bharathcoorg7@gmail.com>",