@bridge-ds/mcp 0.2.0 → 0.3.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/README.md CHANGED
@@ -7,28 +7,31 @@ propose token changes as reviewable branches and pull requests. It never writes
7
7
  Free and open source (MIT). Local, no backend, no account: it reads files on your disk, or a GitHub repo
8
8
  with your own token.
9
9
 
10
- > Not published to npm yet. The `npx @bridge-ds/mcp` commands below work once it is; until then use the local
11
- > path form (`node packages/mcp/dist/index.js`).
12
-
13
10
  ## Run it
14
11
 
12
+ From npm, nothing to build:
13
+
15
14
  ```sh
16
- npm run mcp:build # builds packages/mcp and packages/cli
17
- node packages/mcp/dist/index.js --root . # local repo (default: current directory)
18
- node packages/mcp/dist/index.js --repo owner/name # GitHub repo, read-only
19
- GITHUB_TOKEN=... node packages/mcp/dist/index.js --repo owner/name # GitHub repo, can open PRs
15
+ npx -y @bridge-ds/mcp --repo owner/name # GitHub repo, read-only
16
+ GITHUB_TOKEN=... npx -y @bridge-ds/mcp --repo owner/name # GitHub repo, can open PRs
17
+ npx -y @bridge-ds/mcp --root . # local folder (default: current directory)
18
+ npx -y @bridge-ds/mcp --help
20
19
  ```
21
20
 
22
21
  Connect it to Claude Code:
23
22
 
24
23
  ```sh
25
- claude mcp add bridge -- node /abs/path/to/packages/mcp/dist/index.js --root /abs/path/to/your-ds
26
- # once published:
27
- claude mcp add bridge -- npx -y @bridge-ds/mcp
24
+ claude mcp add bridge -s user -- npx -y @bridge-ds/mcp --repo owner/name
25
+ # so Claude can open pull requests (a fine-grained token limited to that repo):
26
+ claude mcp add bridge -s user -e GITHUB_TOKEN=your-github-token -- npx -y @bridge-ds/mcp --repo owner/name
27
+ # or a local checkout:
28
+ claude mcp add bridge -- npx -y @bridge-ds/mcp --root /abs/path/to/your-ds
28
29
  ```
29
30
 
30
- Or commit a project `.mcp.json` (this repo has one), or run `bridge init`. Claude Desktop, other clients
31
- and the full guide: [docs/AI.md](../../docs/AI.md).
31
+ Or commit a project `.mcp.json`. Claude Desktop, other clients and the full guide: [docs/AI.md](../../docs/AI.md).
32
+
33
+ Working on the server itself: `npm run mcp:build` in a clone of this repo builds it to
34
+ `packages/mcp/dist/index.js`, which this repo's own `.mcp.json` runs.
32
35
 
33
36
  ## Modes
34
37