@splicr/mcp-server 0.3.4 → 0.3.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +87 -0
  2. package/package.json +2 -2
package/README.md ADDED
@@ -0,0 +1,87 @@
1
+ # @splicr/mcp-server
2
+
3
+ Route what you read to what you're building. Splicr captures knowledge from anywhere — articles, tweets, docs, code snippets — and surfaces it inside your coding agent exactly when you need it.
4
+
5
+ ## Quick Start
6
+
7
+ ```bash
8
+ npx @splicr/mcp-server setup
9
+ ```
10
+
11
+ That's it. This will:
12
+
13
+ 1. Open your browser to sign in (email + verification code, no password)
14
+ 2. Auto-detect your coding agents (Claude Code, Cursor, Codex, Cline, Antigravity)
15
+ 3. Configure Splicr in each one
16
+
17
+ One-time login. Token never expires.
18
+
19
+ ## Commands
20
+
21
+ | Command | Description |
22
+ |---------|-------------|
23
+ | `npx @splicr/mcp-server setup` | One-time setup: sign in + auto-configure all agents |
24
+ | `npx @splicr/mcp-server login` | Re-authenticate (opens browser) |
25
+ | `npx @splicr/mcp-server uninstall` | Remove Splicr from all agents + delete credentials |
26
+ | `npx @splicr/mcp-server help` | Show all commands |
27
+
28
+ ## Manual Configuration
29
+
30
+ If you prefer to configure manually, or use an agent that isn't auto-detected, add this to your agent's MCP settings:
31
+
32
+ ```json
33
+ {
34
+ "mcpServers": {
35
+ "splicr": {
36
+ "command": "npx",
37
+ "args": ["-y", "@splicr/mcp-server"]
38
+ }
39
+ }
40
+ }
41
+ ```
42
+
43
+ **Config file locations:**
44
+
45
+ | Agent | Config Path |
46
+ |-------|-------------|
47
+ | Claude Code | Run `claude mcp add --scope user splicr -- npx -y @splicr/mcp-server` |
48
+ | Cursor | `~/.cursor/mcp.json` |
49
+ | Cline (VS Code) | VS Code settings > Cline MCP |
50
+ | Antigravity | `~/.gemini/antigravity/mcp_config.json` |
51
+ | Codex | Run `codex mcp add splicr -- npx -y @splicr/mcp-server` |
52
+
53
+ ## MCP Tools
54
+
55
+ Once connected, your coding agent gets these tools:
56
+
57
+ | Tool | Description |
58
+ |------|-------------|
59
+ | `search_knowledge` | Semantic search across your saved knowledge |
60
+ | `get_project_context` | New captures since last session (watermark-based) |
61
+ | `get_recent_insights` | Cross-project view of recent saves |
62
+ | `save_from_agent` | Save knowledge back to Splicr from your agent |
63
+ | `retry_failed` | Retry captures that failed processing |
64
+
65
+ ## How to Capture
66
+
67
+ - **Telegram**: Send any link to [@splicr_bot](https://t.me/splicr_bot)
68
+ - **Browser**: Chrome extension (coming soon)
69
+ - **Mobile**: Share sheet app (coming soon)
70
+
71
+ AI automatically distills each save into an insight, routes it to your active projects, and generates embeddings for semantic search.
72
+
73
+ ## Auth
74
+
75
+ Splicr uses passwordless authentication:
76
+
77
+ 1. `setup` opens your browser
78
+ 2. Enter your email, get a 6-digit verification code
79
+ 3. Enter the code — done. Permanent API token saved to `~/.splicr/auth.json`
80
+
81
+ No passwords. No token refresh. No expiry.
82
+
83
+ ## Links
84
+
85
+ - Website: [splicr.dev](https://splicr.dev)
86
+ - Telegram bot: [@splicr_bot](https://t.me/splicr_bot)
87
+ - GitHub: [github.com/c0ncepT23/Splicr](https://github.com/c0ncepT23/Splicr)
package/package.json CHANGED
@@ -1,10 +1,10 @@
1
1
  {
2
2
  "name": "@splicr/mcp-server",
3
- "version": "0.3.4",
3
+ "version": "0.3.5",
4
4
  "description": "Splicr MCP server — route what you read to what you're building",
5
5
  "type": "module",
6
6
  "bin": "./dist/cli.js",
7
- "files": ["dist"],
7
+ "files": ["dist", "README.md"],
8
8
  "keywords": ["mcp", "splicr", "knowledge-base", "claude-code", "ai-agent"],
9
9
  "repository": { "type": "git", "url": "https://github.com/c0ncepT23/Splicr.git", "directory": "packages/mcp-server" },
10
10
  "license": "MIT",