mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-05-14 04:02:26 +00:00
31224b9b5c
Extends the Windows-gating work to the optional-skills/ tree. Every
SKILL.md that previously omitted the platforms: field now carries an
explicit declaration, which Hermes's loader (agent.skill_utils.
skill_matches_platform) honors to skip-load on incompatible OSes.
58 skills declared cross-platform (platforms: [linux, macos, windows]):
autonomous-ai-agents/blackbox, autonomous-ai-agents/honcho
blockchain/base, blockchain/solana
communication/one-three-one-rule
creative/blender-mcp, creative/concept-diagrams, creative/hyperframes,
creative/kanban-video-orchestrator, creative/meme-generation
devops/cli (inference-sh-cli), devops/docker-management
dogfood/adversarial-ux-test
email/agentmail
finance/3-statement-model, finance/comps-analysis, finance/dcf-model,
finance/excel-author, finance/lbo-model, finance/merger-model,
finance/pptx-author
health/fitness-nutrition, health/neuroskill-bci
mcp/fastmcp, mcp/mcporter
migration/openclaw-migration
mlops/accelerate, mlops/chroma, mlops/clip, mlops/guidance,
mlops/hermes-atropos-environments, mlops/huggingface-tokenizers,
mlops/instructor, mlops/lambda-labs, mlops/llava, mlops/modal,
mlops/peft, mlops/pinecone, mlops/pytorch-lightning, mlops/qdrant,
mlops/saelens, mlops/simpo, mlops/stable-diffusion
productivity/canvas, productivity/shop-app, productivity/shopify,
productivity/siyuan, productivity/telephony
research/domain-intel, research/drug-discovery, research/duckduckgo-search,
research/gitnexus-explorer, research/parallel-cli, research/scrapling
security/1password, security/oss-forensics, security/sherlock
web-development/page-agent
5 skills gated from Windows (platforms: [linux, macos]):
mlops/flash-attention - Flash Attention wheels are Linux-first; Windows
install requires building from source with CUDA
mlops/faiss - faiss-gpu has no Windows wheel; gate rather than
leak partial (faiss-cpu) support
mlops/nemo-curator - NVIDIA NeMo ecosystem has no first-class Windows path
mlops/slime - Megatron+SGLang RL stack is Linux-only in practice
mlops/whisper - openai-whisper + ffmpeg setup on Windows is
non-trivial; gate until Windows install stanza lands
Methodology: scanned every SKILL.md for Windows-hostile signals
(apt-get, brew, systemd, osascript, ptrace, X11 binaries, POSIX-only
Python APIs, Docker POSIX $(pwd) bind-mounts, explicit 'linux-only' /
'macos-only' text). 3 skills flagged as having hard signals on review:
docker-management and qdrant only had POSIX $(pwd) docker examples and
the tools themselves (Docker Desktop, Qdrant) run fine on Windows —
declared ALL. whisper had an apt/brew ffmpeg install path and nothing
else but the openai-whisper Windows install story is rough enough to
warrant gating.
Strict-over-lenient policy: when in doubt, gate. Easier to un-gate after
verified Windows support lands than to leak partial support that
manifests as mid-task failures for Windows users.
123 lines
3.1 KiB
Markdown
123 lines
3.1 KiB
Markdown
---
|
|
name: mcporter
|
|
description: Use the mcporter CLI to list, configure, auth, and call MCP servers/tools directly (HTTP or stdio), including ad-hoc servers, config edits, and CLI/type generation.
|
|
version: 1.0.0
|
|
author: community
|
|
license: MIT
|
|
platforms: [linux, macos, windows]
|
|
metadata:
|
|
hermes:
|
|
tags: [MCP, Tools, API, Integrations, Interop]
|
|
homepage: https://mcporter.dev
|
|
prerequisites:
|
|
commands: [npx]
|
|
---
|
|
|
|
# mcporter
|
|
|
|
Use `mcporter` to discover, call, and manage [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) servers and tools directly from the terminal.
|
|
|
|
## Prerequisites
|
|
|
|
Requires Node.js:
|
|
```bash
|
|
# No install needed (runs via npx)
|
|
npx mcporter list
|
|
|
|
# Or install globally
|
|
npm install -g mcporter
|
|
```
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
# List MCP servers already configured on this machine
|
|
mcporter list
|
|
|
|
# List tools for a specific server with schema details
|
|
mcporter list <server> --schema
|
|
|
|
# Call a tool
|
|
mcporter call <server.tool> key=value
|
|
```
|
|
|
|
## Discovering MCP Servers
|
|
|
|
mcporter auto-discovers servers configured by other MCP clients (Claude Desktop, Cursor, etc.) on the machine. To find new servers to use, browse registries like [mcpfinder.dev](https://mcpfinder.dev) or [mcp.so](https://mcp.so), then connect ad-hoc:
|
|
|
|
```bash
|
|
# Connect to any MCP server by URL (no config needed)
|
|
mcporter list --http-url https://some-mcp-server.com --name my_server
|
|
|
|
# Or run a stdio server on the fly
|
|
mcporter list --stdio "npx -y @modelcontextprotocol/server-filesystem" --name fs
|
|
```
|
|
|
|
## Calling Tools
|
|
|
|
```bash
|
|
# Key=value syntax
|
|
mcporter call linear.list_issues team=ENG limit:5
|
|
|
|
# Function syntax
|
|
mcporter call "linear.create_issue(title: \"Bug fix needed\")"
|
|
|
|
# Ad-hoc HTTP server (no config needed)
|
|
mcporter call https://api.example.com/mcp.fetch url=https://example.com
|
|
|
|
# Ad-hoc stdio server
|
|
mcporter call --stdio "bun run ./server.ts" scrape url=https://example.com
|
|
|
|
# JSON payload
|
|
mcporter call <server.tool> --args '{"limit": 5}'
|
|
|
|
# Machine-readable output (recommended for Hermes)
|
|
mcporter call <server.tool> key=value --output json
|
|
```
|
|
|
|
## Auth and Config
|
|
|
|
```bash
|
|
# OAuth login for a server
|
|
mcporter auth <server | url> [--reset]
|
|
|
|
# Manage config
|
|
mcporter config list
|
|
mcporter config get <key>
|
|
mcporter config add <server>
|
|
mcporter config remove <server>
|
|
mcporter config import <path>
|
|
```
|
|
|
|
Config file location: `./config/mcporter.json` (override with `--config`).
|
|
|
|
## Daemon
|
|
|
|
For persistent server connections:
|
|
```bash
|
|
mcporter daemon start
|
|
mcporter daemon status
|
|
mcporter daemon stop
|
|
mcporter daemon restart
|
|
```
|
|
|
|
## Code Generation
|
|
|
|
```bash
|
|
# Generate a CLI wrapper for an MCP server
|
|
mcporter generate-cli --server <name>
|
|
mcporter generate-cli --command <url>
|
|
|
|
# Inspect a generated CLI
|
|
mcporter inspect-cli <path> [--json]
|
|
|
|
# Generate TypeScript types/client
|
|
mcporter emit-ts <server> --mode client
|
|
mcporter emit-ts <server> --mode types
|
|
```
|
|
|
|
## Notes
|
|
|
|
- Use `--output json` for structured output that's easier to parse
|
|
- Ad-hoc servers (HTTP URL or `--stdio` command) work without any config — useful for one-off calls
|
|
- OAuth auth may require interactive browser flow — use `terminal(command="mcporter auth <server>", pty=true)` if needed
|