https://github.com/agrublev/fc-remote-mcp
https://github.com/agrublev/fc-remote-mcp
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/agrublev/fc-remote-mcp
- Owner: agrublev
- License: mit
- Created: 2026-05-08T02:12:50.000Z (2 months ago)
- Default Branch: master
- Last Pushed: 2026-05-08T02:20:28.000Z (2 months ago)
- Last Synced: 2026-05-08T04:27:10.574Z (2 months ago)
- Language: JavaScript
- Size: 13.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# fc-remote-mcp
Connect stdio-only MCP clients (Claude Desktop, Cursor, etc.) to remote MCP servers over HTTP/SSE — with optional OAuth or static auth headers. A lightweight clone of [`mcp-remote`](https://github.com/geelen/mcp-remote) tuned for Freedcamp's MCP server.
## Install
Run on demand with `npx` (no install required):
```bash
npx fc-remote-mcp [options]
```
Or install globally:
```bash
npm install -g fc-remote-mcp
```
## Usage
```bash
fc-remote [options]
```
### Options
- `--transport ` — `http-only`, `sse-only`, or `auto` (default: `auto`)
- `--header "Name: value"` — add a custom header (repeatable). Use this to pass static API keys / secrets.
- `--allow-http` — permit non-HTTPS server URLs (for local dev)
- `--debug` — verbose logging to stderr
- `--help`, `--version`
### Example — Freedcamp with static API headers
```bash
npx fc-remote-mcp https://mcp.freedcamp.top/mcp \
--transport http-only \
--header "X-Freedcamp-Api-Key: " \
--header "X-Freedcamp-Api-Secret: "
```
### Example — OAuth-protected server
```bash
npx fc-remote-mcp https://example.com/mcp
```
A browser window will open for the OAuth login flow; tokens are cached under `~/.mcp-auth/`.
## Wire it into an MCP client
Most stdio MCP clients accept a JSON config like:
```json
{
"mcpServers": {
"freedcamp": {
"command": "npx",
"args": [
"-y",
"fc-remote-mcp",
"https://mcp.freedcamp.top/mcp",
"--transport", "http-only",
"--header", "X-Freedcamp-Api-Key: ",
"--header", "X-Freedcamp-Api-Secret: "
]
}
}
}
```
The proxy speaks stdio to the client and forwards every JSON-RPC message to the remote server.
## Diagnostic client
A standalone client is bundled to verify a remote server end-to-end without an MCP host:
```bash
npx -p fc-remote-mcp fc-remote-client [options]
```
It connects, lists tools/resources/prompts, and exits.
## Requirements
- Node.js >= 18
## License
MIT