@agent-workspace/mcp-server 0.2.0 → 0.2.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.
Files changed (2) hide show
  1. package/README.md +66 -0
  2. package/package.json +2 -2
package/README.md ADDED
@@ -0,0 +1,66 @@
1
+ # @agent-workspace/mcp-server
2
+
3
+ MCP server for the [Agent Workspace Protocol](https://github.com/marcoloco23/awp) — plug any AWP workspace into Claude Code, Cursor, or any MCP-compatible client.
4
+
5
+ ## Setup
6
+
7
+ ### Claude Code
8
+
9
+ ```bash
10
+ claude mcp add awp-workspace -- npx @agent-workspace/mcp-server
11
+ ```
12
+
13
+ ### With a specific workspace path
14
+
15
+ ```bash
16
+ AWP_WORKSPACE=/path/to/workspace npx @agent-workspace/mcp-server
17
+ ```
18
+
19
+ ### Generic MCP client
20
+
21
+ The server communicates over stdio using the [Model Context Protocol](https://modelcontextprotocol.io). Point any MCP client at:
22
+
23
+ ```bash
24
+ npx @agent-workspace/mcp-server
25
+ ```
26
+
27
+ It will auto-discover the AWP workspace from the current directory (or use `AWP_WORKSPACE` env var).
28
+
29
+ ## Tools
30
+
31
+ | Tool | Description |
32
+ |------|-------------|
33
+ | `awp_read_identity` | Read agent identity (name, capabilities, DID) |
34
+ | `awp_read_soul` | Read behavioral constraints (values, boundaries, governance) |
35
+ | `awp_read_user` | Read human profile |
36
+ | `awp_read_memory` | Read memory (daily or long-term) |
37
+ | `awp_write_memory` | Log structured memory entries |
38
+ | `awp_artifact_read` | Read a knowledge artifact by slug |
39
+ | `awp_artifact_write` | Create or update a knowledge artifact |
40
+ | `awp_artifact_list` | List all artifacts (optional tag filter) |
41
+ | `awp_artifact_search` | Search artifacts by content, title, or tags |
42
+ | `awp_workspace_status` | Workspace summary (files present, memory count, artifact count) |
43
+
44
+ ## How It Works
45
+
46
+ The MCP server reads and writes AWP workspace files directly — no database, no daemon. Your agent's identity, memory, and knowledge artifacts are just Markdown files with YAML frontmatter, stored in a directory and compatible with Git.
47
+
48
+ When an AI agent connects via MCP, it can:
49
+ - **Read** its identity, soul, and user context at the start of each session
50
+ - **Write** memory entries as it works
51
+ - **Create and update** knowledge artifacts with full provenance tracking
52
+ - **Search** its accumulated knowledge
53
+
54
+ ## Part of AWP
55
+
56
+ This package is part of the [Agent Workspace Protocol](https://github.com/marcoloco23/awp) monorepo:
57
+
58
+ | Package | Description |
59
+ |---------|-------------|
60
+ | [@agent-workspace/core](https://www.npmjs.com/package/@agent-workspace/core) | Types, constants, JSON schemas |
61
+ | [@agent-workspace/cli](https://www.npmjs.com/package/@agent-workspace/cli) | CLI tool |
62
+ | **@agent-workspace/mcp-server** | MCP server |
63
+
64
+ ## License
65
+
66
+ Apache-2.0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@agent-workspace/mcp-server",
3
- "version": "0.2.0",
3
+ "version": "0.2.1",
4
4
  "description": "MCP server exposing Agent Workspace Protocol operations — plug any AWP workspace into any MCP client",
5
5
  "license": "Apache-2.0",
6
6
  "type": "module",
@@ -39,7 +39,7 @@
39
39
  "prepublishOnly": "npm run build"
40
40
  },
41
41
  "dependencies": {
42
- "@agent-workspace/core": "0.2.0",
42
+ "@agent-workspace/core": "0.2.1",
43
43
  "@modelcontextprotocol/sdk": "^1.0.0",
44
44
  "gray-matter": "^4.0.3",
45
45
  "zod": "^4.3.6"