@abraca/mcp 2.4.0 → 2.6.0
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/README.md +32 -0
- package/dist/abracadabra-mcp.cjs +336 -139
- package/dist/abracadabra-mcp.cjs.map +1 -1
- package/dist/abracadabra-mcp.esm.js +337 -140
- package/dist/abracadabra-mcp.esm.js.map +1 -1
- package/dist/index.d.ts +41 -0
- package/package.json +2 -2
- package/src/resources/tree-resource.ts +6 -1
- package/src/server.ts +273 -7
- package/src/tools/awareness.ts +1 -1
- package/src/tools/channel.ts +5 -3
- package/src/tools/content.ts +26 -15
- package/src/tools/meta.ts +8 -4
- package/src/tools/tree.ts +24 -21
package/README.md
ADDED
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# @abraca/mcp
|
|
2
|
+
|
|
3
|
+
A Model Context Protocol server that exposes an Abracadabra space to AI tooling — documents, tree, content, metadata, files, chat, and presence over stdio. Bin: `abracadabra-mcp`.
|
|
4
|
+
|
|
5
|
+
## Documentation
|
|
6
|
+
|
|
7
|
+
Full, code-derived documentation lives in [`docs/`](docs/) — a numbered Nuxt-Content
|
|
8
|
+
site covering startup/transport, every env var, all 27 tools, the 3 resources, schema
|
|
9
|
+
validation, and the channel/dispatch model + gotchas. It is the source of truth.
|
|
10
|
+
|
|
11
|
+
## Quick start
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
ABRA_URL=https://my-server.example.com abracadabra-mcp
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
Identity is an Ed25519 key file (`ABRA_KEY_FILE`, default `~/.abracadabra/agent.key`); the agent auto-registers on first run (`ABRA_INVITE_CODE` optional). See [`docs/1.getting-started/configuration`](docs/1.getting-started/2.configuration.md) for every variable.
|
|
18
|
+
|
|
19
|
+
## Highlights
|
|
20
|
+
|
|
21
|
+
- **27 tools** — tree/documents, content/meta, files, channel (`reply`, `send_chat_message`), awareness, SVG, hooks.
|
|
22
|
+
- **3 resources** — `agent-guide` (the authoritative in-band reference), `server-info`, `tree`.
|
|
23
|
+
- **Opt-in schema validation** via `ABRA_MCP_SCHEMA_BUNDLE` (a `@abraca/schema` bundle).
|
|
24
|
+
- **Hook bridge** mirrors Claude Code tool activity into the agent's presence.
|
|
25
|
+
|
|
26
|
+
::
|
|
27
|
+
|
|
28
|
+
> Plain text is invisible to users — chat replies go via `send_chat_message`, ai:task answers via `reply`. `read_document`'s body is **not** full content (children are content). See [`docs/4.reference/`](docs/4.reference/1.auth-channel-gotchas.md).
|
|
29
|
+
|
|
30
|
+
## License
|
|
31
|
+
|
|
32
|
+
MIT.
|