# Hermes MCP Server ??

A lightweight [Model Context Protocol](https://modelcontextprotocol.io) server built with pure Node.js ? **zero dependencies**, 9 built-in tools.

## Quick Start

```bash
# No install needed ? just run with Node.js
node server.mjs
```

Send JSON-RPC 2.0 messages over stdin:

```json
{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}
```

## CLI Client

The repo includes `mcp.mjs` ? a convenient CLI wrapper:

```bash
node mcp.mjs system_info
node mcp.mjs web_search_github query="OpenClaw" limit=3
node mcp.mjs web_fetch url="https://example.com"
node mcp.mjs memory_store key="hello" value="world"
node mcp.mjs memory_get key="hello"
```

## Available Tools

| Tool | Description |
|------|-------------|
| `system_info` | OS, hostname, arch, Node version |
| `web_fetch` | Fetch any URL (with timeout) |
| `web_search_github` | Search GitHub repositories |
| `file_read` | Read file content |
| `file_write` | Write content to file |
| `file_list` | List directory contents |
| `shell_exec` | Execute shell commands |
| `memory_store` | Persist key-value data |
| `memory_get` | Retrieve stored data |

## Why?

MCP lets AI agents use tools in a standardized way. This server provides a foundation for:
- Adding web search and file operations to any MCP-compatible agent
- Building custom MCP toolchains
- Learning the MCP protocol internals

## License

MIT