{"_id":"@axon-protocol/clipboard-server","name":"@axon-protocol/clipboard-server","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@axon-protocol/clipboard-server","version":"0.1.0","description":"AXON Clipboard History Server — Cross-platform clipboard management with history, search, and pinning via system commands","type":"module","main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"bin":{"axon-clipboard":"src/mcp-stdio.ts"},"scripts":{"build":"tsc","prepublishOnly":"npm run build","start":"npx tsx src/index.ts","mcp":"npx tsx src/mcp-stdio.ts","dev":"npx tsx --watch src/index.ts"},"keywords":["axon","clipboard","history","pbcopy","pbpaste","xclip","mcp","ai-agent","tools"],"repository":{"type":"git","url":"git+https://github.com/hchihoub/axon-protocol.git","directory":"servers/clipboard"},"homepage":"https://github.com/hchihoub/axon-protocol#readme","author":{"name":"AXON Protocol Contributors"},"license":"MIT","dependencies":{},"peerDependencies":{"@axon-protocol/sdk":"^0.1.0"},"devDependencies":{"typescript":"^5.4.0","tsx":"^4.7.0"},"gitHead":"7f39259c0dec0b320371c8ab84ea3d2b1e3bdd58","_id":"@axon-protocol/clipboard-server@0.1.0","bugs":{"url":"https://github.com/hchihoub/axon-protocol/issues"},"_nodeVersion":"25.8.0","_npmVersion":"11.11.0","dist":{"integrity":"sha512-31S4mKxT6zErGrXSXnvKwSazb6B01qkiP03+DEpyUloH32flvE8JhJVUnNtQv76h+BFdZuSYGKm4y1QWYaKQhg==","shasum":"5a1580987c0ac6d9847e9c9ae2e7cda27054fbbd","tarball":"https://registry.npmjs.org/@axon-protocol/clipboard-server/-/clipboard-server-0.1.0.tgz","fileCount":22,"unpackedSize":88284,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCePi1bZnM1ZaBbht+njNnmdHUh6t1TdkOPpLHyjY3/WQIgR6ZXxHJPFu6HOwioEAbRWlRyOP1dH9lVS/XV8tFo0Wg="}]},"_npmUser":{"name":"hec-28","email":"chihoub.houssem@gmail.com"},"directories":{},"maintainers":[{"name":"hec-28","email":"chihoub.houssem@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/clipboard-server_0.1.0_1773680547890_0.08143249956305043"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-16T17:02:27.837Z","0.1.0":"2026-03-16T17:02:28.029Z","modified":"2026-03-16T17:02:28.233Z"},"maintainers":[{"name":"hec-28","email":"chihoub.houssem@gmail.com"}],"description":"AXON Clipboard History Server — Cross-platform clipboard management with history, search, and pinning via system commands","homepage":"https://github.com/hchihoub/axon-protocol#readme","keywords":["axon","clipboard","history","pbcopy","pbpaste","xclip","mcp","ai-agent","tools"],"repository":{"type":"git","url":"git+https://github.com/hchihoub/axon-protocol.git","directory":"servers/clipboard"},"author":{"name":"AXON Protocol Contributors"},"bugs":{"url":"https://github.com/hchihoub/axon-protocol/issues"},"license":"MIT","readme":"# @axon-protocol/clipboard-server\n\nAXON Clipboard History Server — Cross-platform clipboard management with history, search, and pinning.\n\n## Features\n\n- **Cross-platform** clipboard access (macOS, Linux, Windows)\n- **Persistent history** stored at `~/.axon/clipboard-history.json`\n- **Pin entries** to prevent eviction when history reaches max size\n- **Search** through clipboard history with text matching\n- **Zero external dependencies** — uses only Node.js built-ins and system commands\n\n## Platform Support\n\n| Platform | Read Command | Write Command |\n|----------|-------------|---------------|\n| macOS | `pbpaste` | `pbcopy` |\n| Linux | `xclip -selection clipboard -o` | `xclip -selection clipboard` |\n| Windows | `Get-Clipboard` (PowerShell) | `Set-Clipboard` (PowerShell) |\n\n## Tools\n\n| Tool | Description | Read-only |\n|------|-------------|-----------|\n| `get_clipboard` | Get current clipboard content | Yes |\n| `set_clipboard` | Set clipboard content | No |\n| `get_history` | Get clipboard history (most recent N) | Yes |\n| `search_history` | Search clipboard history by text | Yes |\n| `pin_entry` | Pin/unpin a clipboard entry | No |\n| `clear_history` | Clear clipboard history | No |\n\n## Usage\n\n### As MCP Server (Claude Desktop, Cursor, etc.)\n\n```json\n{\n  \"mcpServers\": {\n    \"clipboard\": {\n      \"command\": \"npx\",\n      \"args\": [\"tsx\", \"src/mcp-stdio.ts\"],\n      \"cwd\": \"/path/to/servers/clipboard\"\n    }\n  }\n}\n```\n\n### Programmatic\n\n```typescript\nimport { launchClipboardServer } from \"@axon-protocol/clipboard-server\";\n\nconst { server, cm } = await launchClipboardServer({\n  maxHistory: 200,\n});\n\nconsole.log(`${server.toolCount} tools ready`);\n```\n\n## Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `AXON_CLIPBOARD_MAX_HISTORY` | Maximum history entries | `100` |\n| `AXON_CLIPBOARD_HISTORY_PATH` | Custom history file path | `~/.axon/clipboard-history.json` |\n\n## Development\n\n```bash\nnpm run dev    # Watch mode\nnpm run build  # Compile TypeScript\nnpm run mcp    # Start MCP stdio server\n```\n","readmeFilename":"README.md","_rev":"1-be6cfbf65028b5e7c109f524085d1695"}