intermcp 0.2.1 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +22 -21
  2. package/index.js +2 -2
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -10,7 +10,7 @@
10
10
  ```
11
11
 
12
12
  ### Ultra-Fast, Safe Model Context Protocol (MCP) Engine & Multiplexing Hub in Pure Rust
13
- **Sub-millisecond dispatch • 457,000+ ping ops/sec* • < 3.8 MB RAM • SafeFS Sandboxing • 1-Click Multi-IDE Setup**
13
+ **Sub-millisecond dispatch • pending benchmark • SafeFS Sandboxing • 1-Click Multi-IDE Setup**
14
14
 
15
15
  *Ultra-fast, safe Model Context Protocol (MCP) engine and multiplexing hub in pure Rust, built for Interlayer Blockchain and open for all.*
16
16
 
@@ -18,29 +18,20 @@
18
18
  <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>
19
19
  <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>
20
20
  <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>
21
- <a href="https://github.com/Bharathcoorg/intermcp/releases/tag/v0.2.1"><img src="https://img.shields.io/github/v/release/Bharathcoorg/intermcp?style=for-the-badge&logo=github" alt="GitHub release" /></a>
21
+ <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>
22
22
  <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>
23
23
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg?style=for-the-badge" alt="License: MIT" /></a>
24
24
  </p>
25
25
 
26
- [Quickstart](#-1-click-installation--setup) • [Packages](#-official-packages--sdks) • [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) • [Security](#-security--vulnerability-reporting)
27
-
28
- ---
29
-
30
- </div>
31
-
32
- ## 📦 Official Packages & SDKs
33
-
34
- InterMCP core and multi-language client SDKs are officially published and immediately available across all major package ecosystems:
35
-
36
- | Ecosystem | Registry / Source | Install Command | Registry Links |
26
+ | Platform / Ecosystem | Package Registry | Install Command | Links / Badges |
37
27
  | :--- | :--- | :--- | :--- |
38
- | **Rust** | **crates.io** | `cargo add 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) |
28
+ | **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) |
29
+ | **Rust (Library SDK)** | **crates.io** | `cargo add intermcp` | [docs.rs/intermcp](https://docs.rs/intermcp) |
39
30
  | **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) |
40
- | **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/) |
41
- | **Go** | **Go Modules** | `go get github.com/Bharathcoorg/intermcp/go/intermcp@v0.2.1` | [pkg.go.dev/github.com/Bharathcoorg/intermcp/go/intermcp](https://pkg.go.dev/github.com/Bharathcoorg/intermcp/go/intermcp) |
31
+ | **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) |
32
+ | **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) |
42
33
  | **PHP** | **Packagist** | `composer require bharathcoorg/intermcp` | [packagist.org/packages/bharathcoorg/intermcp](https://packagist.org/packages/bharathcoorg/intermcp) |
43
- | **Standalone Binaries** | **GitHub Releases** | Prebuilt binaries for Linux, macOS (ARM & Intel), Windows | [GitHub v0.2.1 Release Assets](https://github.com/Bharathcoorg/intermcp/releases/tag/v0.2.1) |
34
+ | **Standalone Binaries** | **GitHub Releases** | Prebuilt binaries for Linux, macOS (ARM & Intel), Windows | [GitHub Releases](https://github.com/Bharathcoorg/intermcp/releases) |
44
35
 
45
36
  ---
46
37
 
@@ -50,7 +41,7 @@ The **Model Context Protocol (MCP)** standardizes how language models (Claude De
50
41
 
51
42
  **`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:
52
43
  - **Low-Latency Routing**: sub-millisecond in-process dispatch (see bench).
53
- - **Minimal Footprint**: Operates in under 3.8 MB of resident memory (RSS).
44
+ - **Minimal Footprint**: Operates with minimal resident memory (RSS; pending benchmark).
54
45
  - **SafeFS Sandboxing**: Canonical path containment preventing unauthorized directory traversal and symlink escapes.
55
46
  - **Universal Multiplexing Hub**: Spawns, health-checks, and aggregates multiple external MCP servers into a single stdio pipe.
56
47
  - **Dynamic Tool Discovery**: Reduces LLM context token consumption by injecting tool schemas on demand.
@@ -91,10 +82,18 @@ npx intermcp serve
91
82
 
92
83
  #### Option B: Via Cargo (Rust Developers)
93
84
  ```bash
85
+ # Install the standalone binary globally
94
86
  cargo install intermcp
87
+
88
+ # Or install precompiled binary instantly without compilation:
89
+ cargo binstall intermcp
90
+
91
+ # Run 1-click configuration
95
92
  intermcp setup
96
93
  ```
97
94
 
95
+ > 💡 **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`).
96
+
98
97
  ---
99
98
 
100
99
  ## 🎯 Supported IDEs & AI Environments
@@ -123,9 +122,9 @@ Micro-benchmarks conducted on an AMD Ryzen 9 / Apple Silicon system processing 5
123
122
  | Metric | Reference Node.js SDK (`@modelcontextprotocol/sdk`) | Reference Python SDK (`mcp`) | **InterMCP (Pure Rust)** |
124
123
  | :--- | :---: | :---: | :---: |
125
124
  | **Cold Boot Latency** | 420 ms | 680 ms | **0.4 ms** |
126
- | **Memory Footprint (RSS)** | 162 MB | 114 MB | **< 3.8 MB** |
125
+ | **Memory Footprint (RSS)** | 162 MB | 114 MB | **pending benchmark** |
127
126
  | **Average Dispatch Latency** | 45.0 ms | 62.0 ms | **sub-millisecond (< 5 µs in-process)** |
128
- | **Throughput (Single Core)** | 1,420 ops/s | 890 ops/s | **457,042 ops/s\*** |
127
+ | **Throughput (Single Core)** | 1,420 ops/s | 890 ops/s | **pending benchmark** |
129
128
  | **Runtime Dependencies** | Node.js + npm dependencies | Python 3.10+ + virtualenv | **None (Static Binary)** |
130
129
 
131
130
  Reproduce locally with:
@@ -256,6 +255,8 @@ Implements the **2024-11-05 Model Context Protocol specification**:
256
255
  - `system_info`, `system_run_command`
257
256
  - `intermcp_search_tools` (when `--smart-discovery` is enabled)
258
257
 
258
+ > ⚠️ **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.
259
+
259
260
  ### Resources (`resources/list`, `resources/read`)
260
261
  - `system://diagnostics`: Host architecture, CPU, and process memory telemetry.
261
262
 
@@ -281,7 +282,7 @@ use serde_json::json;
281
282
 
282
283
  #[tokio::main]
283
284
  async fn main() -> Result<()> {
284
- let mut server = Server::new("custom-server", "0.2.1");
285
+ let mut server = Server::new("custom-server", "0.3.0");
285
286
 
286
287
  server.add_tool(Box::new(SimpleTool::new(
287
288
  "calculate_hash",
package/index.js CHANGED
@@ -1,4 +1,4 @@
1
- /** InterMCP Node.js / TypeScript SDK v0.2.1 */
1
+ /** InterMCP Node.js / TypeScript SDK v0.3.0 */
2
2
  const { spawn } = require("child_process");
3
3
  const readline = require("readline");
4
4
  const path = require("path");
@@ -63,7 +63,7 @@ class InterMcpClient {
63
63
  // Handshake
64
64
  await this.request("initialize", {
65
65
  protocolVersion: "2024-11-05",
66
- clientInfo: { name: "intermcp-node-client", version: "0.2.1" },
66
+ clientInfo: { name: "intermcp-node-client", version: "0.3.0" },
67
67
  });
68
68
  }
69
69
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "intermcp",
3
- "version": "0.2.1",
3
+ "version": "0.3.0",
4
4
  "description": "Ultra-fast, safe Model Context Protocol (MCP) engine and multiplexing hub in pure Rust, built for Interlayer Blockchain and open for all",
5
5
  "main": "index.js",
6
6
  "types": "index.d.ts",