obscura-mcp-server 0.1.0 → 0.1.1
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.
- package/.specs/config.yaml +25 -0
- package/INSTALL.md +1 -1
- package/README.md +30 -17
- package/package.json +1 -1
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# .specs/config.yaml — project-wide spec workflow config (free-form, agent-interpreted)
|
|
2
|
+
#
|
|
3
|
+
# This file is read at the start of every spec workflow action (brainstorm,
|
|
4
|
+
# spec init, status, validate, task check, implementation). Edits take effect
|
|
5
|
+
# on the next action. The schema is intentionally free-form: any keys you add
|
|
6
|
+
# are surfaced to the spec agent as project context.
|
|
7
|
+
|
|
8
|
+
project:
|
|
9
|
+
goal: "Short statement of what this project is for."
|
|
10
|
+
tech_stack:
|
|
11
|
+
- "language/runtime"
|
|
12
|
+
- "framework"
|
|
13
|
+
- "datastore"
|
|
14
|
+
|
|
15
|
+
principles:
|
|
16
|
+
tdd: false # write tests first when true
|
|
17
|
+
no_comments: false # omit code comments when true
|
|
18
|
+
# add any other principles your team wants the agent to honor
|
|
19
|
+
|
|
20
|
+
hooks:
|
|
21
|
+
after_task:
|
|
22
|
+
- command: "npm test"
|
|
23
|
+
auto: false # true = agent runs it after each task; false = remind the user
|
|
24
|
+
# - command: "npm run lint"
|
|
25
|
+
# auto: true
|
package/INSTALL.md
CHANGED
package/README.md
CHANGED
|
@@ -40,34 +40,47 @@ Query a webpage using CSS selectors or text search.
|
|
|
40
40
|
|
|
41
41
|
## Installation
|
|
42
42
|
|
|
43
|
+
Add to your MCP servers config:
|
|
44
|
+
|
|
45
|
+
```json
|
|
46
|
+
{
|
|
47
|
+
"mcpServers": {
|
|
48
|
+
"obscura": {
|
|
49
|
+
"command": "bunx",
|
|
50
|
+
"args": ["obscura-mcp-server"]
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
```
|
|
55
|
+
|
|
43
56
|
See [INSTALL.md](./INSTALL.md) for setup with VSCode, Cursor, OpenCode, Claude Code, Codex, and Pi.
|
|
44
57
|
|
|
45
58
|
## Architecture
|
|
46
59
|
|
|
47
60
|
```
|
|
48
61
|
┌─────────────────────────────────────────────────────────────┐
|
|
49
|
-
│
|
|
50
|
-
│
|
|
62
|
+
│ MCP Client │
|
|
63
|
+
│ Coding Agent │
|
|
51
64
|
└─────────────────────────┬───────────────────────────────────┘
|
|
52
65
|
│ JSON-RPC
|
|
53
66
|
▼
|
|
54
67
|
┌─────────────────────────────────────────────────────────────┐
|
|
55
|
-
│ Obscura MCP Server
|
|
56
|
-
│
|
|
57
|
-
│
|
|
58
|
-
│
|
|
59
|
-
│
|
|
60
|
-
│
|
|
68
|
+
│ Obscura MCP Server │
|
|
69
|
+
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
|
|
70
|
+
│ │ fetch │ │ search │ │ query │ ← Tools │
|
|
71
|
+
│ └───┬─────┘ └───┬─────┘ └───┬─────┘ │
|
|
72
|
+
│ │ │ │ │
|
|
73
|
+
│ ▼ ▼ ▼ │
|
|
61
74
|
│ ┌─────────────────────────────────────────────────────────┐│
|
|
62
|
-
│ │
|
|
63
|
-
│
|
|
64
|
-
│
|
|
65
|
-
│
|
|
66
|
-
│
|
|
67
|
-
│
|
|
68
|
-
│
|
|
69
|
-
│
|
|
70
|
-
│
|
|
75
|
+
│ │ checkObscura() ││
|
|
76
|
+
│ └──────────────────────────┬──────────────────────────────┘│
|
|
77
|
+
│ │ │
|
|
78
|
+
│ ┌────────────┴────────────┐ │
|
|
79
|
+
│ ▼ ▼ │
|
|
80
|
+
│ ┌────────────┐ ┌────────────┐ │
|
|
81
|
+
│ │ Obscura │ │ Native │ │
|
|
82
|
+
│. │ (headless) │ │ fetch │ │
|
|
83
|
+
│ └────────────┘ └────────────┘ │
|
|
71
84
|
└─────────────────────────────────────────────────────────────┘
|
|
72
85
|
```
|
|
73
86
|
|