@weibaohui/mcp2cli 0.2.8

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 weibaohui
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,234 @@
+# mcp2cli
+
+> A powerful CLI tool for interacting with MCP (Model Context Protocol) servers
+
+[![Go Version](https://img.shields.io/badge/Go-1.21+-00ADD8?style=flat-square&logo=go)](https://golang.org)
+[![License](https://img.shields.io/badge/License-MIT-green?style=flat-square)](LICENSE)
+
+## Quick Usage
+
+```bash
+# Install
+go install github.com/weibaohui/mcp2cli@latest
+
+# Rename to mcp for convenience
+mv $(go env GOPATH)/bin/mcp2cli $(go env GOPATH)/bin/mcp
+
+# List configured servers (no server connection)
+mcp
+
+# Inspect a server's available tools
+mcp openDeepWiki
+
+# View tool details with parameter examples
+mcp openDeepWiki list_repositories
+
+# Call a tool
+mcp openDeepWiki list_repositories limit=3
+
+# Call with typed arguments (recommended)
+mcp openDeepWiki list_repositories limit:number=3 enabled:bool=true
+```
+
+## Argument Format
+
+Arguments can be in two formats:
+
+```bash
+# Simple key=value (string type by default)
+mcp server tool name=John age=30
+
+# Typed key:type=value (recommended for precision)
+mcp server tool name:string=John age:number=30 enabled:bool=true
+```
+
+**Supported types:** `string`, `number`, `int`, `float`, `bool`
+
+---
+
+## Features
+
+- **🔍 Discover Servers** - List all configured MCP servers without connecting
+- **📋 Explore Tools** - View detailed tool information with formatted parameters
+- **🚀 Invoke Tools** - Call tools directly with type-safe arguments
+- **🔌 Multiple Transports** - Support for SSE, Streamable HTTP, and Stdio
+- **📁 Smart Config** - Auto-detects and merges configs from standard locations
+- **📤 Unified JSON Output** - Machine-readable output for scripting
+
+## Installation
+
+### Binary (latest release)
+
+Download from [GitHub Releases](https://github.com/weibaohui/mcp2cli/releases/latest)
+
+### From source
+
+```bash
+go install github.com/weibaohui/mcp2cli@latest
+```
+
+### Build from source
+
+```bash
+git clone https://github.com/weibaohui/mcp2cli.git
+cd mcp2cli
+make build
+```
+
+## Configuration
+
+Create `~/.config/mcp/config.json`:
+
+```json
+{
+  "mcpServers": {
+    "openDeepWiki": {
+      "url": "https://opendeepwiki.k8m.site/mcp/streamable",
+      "timeout": 30000
+    }
+  }
+}
+```
+
+### Config File Search Paths
+
+| Platform | Priority Order |
+|----------|---------------|
+| macOS/Linux | `~/.config/modelcontextprotocol/mcp.json` → `~/.config/mcp/config.json` → `./mcp.json` → `./.mcp/config.json` → `/etc/mcp/config.json` |
+| Windows | `%APPDATA%\modelcontextprotocol\mcp.json` → `%APPDATA%\mcp\config.json` → `%USERPROFILE%\.mcp\config.json` → `.\mcp.json` → `.\.mcp\config.json` |
+
+### Config File Format
+
+```json
+{
+  "mcpServers": {
+    "serverName": {
+      "transport": "streamable",
+      "url": "https://example.com/mcp",
+      "command": "npx",
+      "args": ["-y", "@server/mcp"],
+      "env": {"KEY": "value"},
+      "timeout": 30000,
+      "headers": {
+        "Authorization": "Bearer ${API_TOKEN}",
+        "X-API-Key": "${API_KEY}"
+      }
+    }
+  }
+}
+```
+
+### Authentication
+
+**HTTP Headers (API Key / Bearer Token):**
+```json
+{
+  "mcpServers": {
+    "secure-server": {
+      "url": "https://api.example.com/mcp",
+      "headers": {
+        "Authorization": "Bearer ${API_TOKEN}",
+        "X-API-Key": "${API_KEY}"
+      }
+    }
+  }
+}
+```
+
+Supports `${VAR}` and `$VAR` environment variable substitution.
+
+**OAuth 2.1 with Static Access Token:**
+```json
+{
+  "mcpServers": {
+    "oauth-server": {
+      "url": "https://api.example.com/mcp",
+      "auth": {
+        "oauth": {
+          "accessToken": "${OAUTH_ACCESS_TOKEN}"
+        }
+      }
+    }
+  }
+}
+```
+
+**Transport Types:**
+| Type | Description |
+|------|-------------|
+| `streamable` | Modern streaming HTTP (default) |
+| `sse` | Server-Sent Events over HTTP |
+| `stdio` | Local subprocess communication |
+
+## Command Reference
+
+```bash
+# List all configured servers
+mcp
+
+# Get server info with tools list
+mcp <server_name>
+
+# Get tool details with parameter examples
+mcp <server_name> <tool_name>
+
+# Call a tool with arguments
+mcp <server_name> <tool_name> <key=value> [key2=value2]...
+```
+
+## Output Format
+
+All commands return unified JSON:
+
+```json
+{
+  "success": true,
+  "data": {
+    "configFiles": ["/home/user/.config/mcp/config.json"],
+    "servers": [
+      {
+        "name": "openDeepWiki",
+        "transport": "streamable",
+        "url": "https://opendeepwiki.k8m.site/mcp/streamable"
+      }
+    ]
+  },
+  "meta": {
+    "timestamp": "2026-03-24T10:00:00Z",
+    "version": "v0.2.8"
+  }
+}
+```
+
+## Architecture
+
+```
+cmd/mcp/main.go          # CLI entry point, argument routing
+internal/mcp/
+  ├── types.go           # Error codes, shared types
+  ├── config.go          # Config loading & merging
+  ├── config_paths.go    # Platform-specific paths
+  ├── client.go          # MCP server client
+  ├── dispatcher.go      # Multi-server coordination
+  └── formatter.go       # Schema formatting, arg parsing
+```
+
+## Development
+
+```bash
+# Build for current platform
+make build
+
+# Build for all platforms
+make build-all
+
+# Run tests
+make test
+
+# Lint code
+make lint
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

package/install.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+const platform = process.platform;
+const arch = process.arch;
+
+// Map platform names
+const platformMap = {
+  'darwin': 'darwin',
+  'linux': 'linux',
+  'win32': 'windows'
+};
+
+// Map arch names - npm uses x64, Go uses amd64
+const archMap = {
+  'x64': 'amd64',
+  'arm64': 'arm64'
+};
+
+const npmPlatform = platformMap[platform];
+const npmArch = archMap[arch];
+
+if (!npmPlatform || !npmArch) {
+  console.error(`Unsupported platform/architecture: ${platform}/${arch}`);
+  process.exit(1);
+}
+
+const binaryName = `mcp2cli-${npmPlatform}-${npmArch}`;
+const binaryPath = path.join(__dirname, 'dist', binaryName);
+const targetPath = path.join(__dirname, 'mcp2cli');
+
+// Add .exe on Windows
+const exeTargetPath = platform === 'win32' ? targetPath + '.exe' : targetPath;
+
+if (!fs.existsSync(binaryPath)) {
+  console.error(`Binary not found: ${binaryPath}`);
+  console.error('Please report this issue at: https://github.com/weibaohui/mcp2cli/issues');
+  process.exit(1);
+}
+
+// Copy binary to target location
+fs.copyFileSync(binaryPath, exeTargetPath);
+
+// Make executable on Unix systems
+if (platform !== 'win32') {
+  fs.chmodSync(exeTargetPath, 0o755);
+}
+
+console.log(`Installed mcp2cli ${npmPlatform}/${npmArch} successfully`);

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@weibaohui/mcp2cli",
+  "version": "0.2.8",
+  "description": "CLI tool for interacting with MCP (Model Context Protocol) Servers",
+  "author": "weibaohui",
+  "license": "MIT",
+  "homepage": "https://github.com/weibaohui/mcp2cli",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/weibaohui/mcp2cli.git"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "cli",
+    "tool"
+  ],
+  "os": [
+    "linux",
+    "darwin",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "main": "index.js",
+  "bin": {
+    "mcp": "./install.js"
+  },
+  "files": [
+    "dist/",
+    "index.js",
+    "install.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "postinstall": "node install.js"
+  }
+}