caoimhinr/pastebin-mcp
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Initial commit

Browse source
This commit is contained in:
caoimhinr 2026-06-02 23:07:29 +02:00
commit 6a1b671d79
3 changed files with 309 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

55
README.md Normal file
View file

@ -0,0 +1,55 @@
# pastebin-mcp
MCP server for the homelab pastebin service. Exposes create, read, list, and delete
operations as MCP tools so agents can interact with pastebin programmatically.
## Tools
| Tool | Auth required | Description |
|------|---------------|-------------|
| `create_paste` | No | Create a paste; returns URL and ID |
| `get_paste` | No | Fetch full paste metadata + content |
| `get_raw` | No | Fetch raw paste text only |
| `list_pastes` | Yes (API key) | List recent pastes with pagination |
| `delete_paste` | Yes (API key) | Permanently delete a paste |
## Environment variables
| Variable | Default | Description |
|----------|---------|-------------|
| `PASTEBIN_URL` | `http://192.168.0.242:3002` | Pastebin service base URL |
| `PASTEBIN_API_KEY` | *(empty)* | API key for privileged operations |
| `PASTEBIN_MCP_TRANSPORT` | `stdio` | Transport: `stdio`, `sse`, or `streamable-http` |
| `FASTMCP_HOST` | `127.0.0.1` | Bind host for HTTP transports |
| `FASTMCP_PORT` | `8000` | Bind port for HTTP transports |
| `FASTMCP_STREAMABLE_HTTP_PATH` | `/mcp` | HTTP path for streamable-http transport |
## Install
```bash
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
```
## Run (HTTP / MCP endpoint)
```bash
PASTEBIN_MCP_TRANSPORT=streamable-http \
FASTMCP_HOST=0.0.0.0 \
FASTMCP_PORT=8004 \
PASTEBIN_API_KEY=<key> \
python mcp_server.py
```
## Run (stdio for Claude Desktop / claude mcp add)
```bash
PASTEBIN_API_KEY=<key> pastebin-mcp
```
## Register globally (HTTP)
```bash
claude mcp add --transport http --scope user pastebin-mcp http://192.168.0.242:8004/mcp
```