oth-mcp 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/README.md +13 -9
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,25 +1,29 @@
|
|
|
1
1
|
# oth-mcp
|
|
2
2
|
|
|
3
|
-
MCP server for
|
|
3
|
+
MCP server for https://doccla-dev.oth.io/api/docs Gives agents direct access to query and manage OTH resources
|
|
4
|
+
|
|
5
|
+
## Design
|
|
6
|
+
|
|
7
|
+
The server is designed for minimal token usage. Instead of embedding the full API reference in tool descriptions, the endpoint guide is exposed as an [MCP resource](https://github.com/doccla-experiments/oth-mcp/blob/main/src/api-guide.ts) (`oth://api-guide`) that the agent loads on demand — only when it needs to look up paths or request bodies. This keeps each tool call lightweight while still giving agents access to the complete reference.
|
|
4
8
|
|
|
5
9
|
## Setup
|
|
6
10
|
|
|
7
11
|
### 1. Configure credentials
|
|
8
12
|
|
|
9
|
-
**
|
|
13
|
+
**macOS Keychain (preferred)** — no plaintext on disk:
|
|
10
14
|
|
|
11
15
|
```bash
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
16
|
+
# For each environment (oth-dev, oth-stag, oth-demo):
|
|
17
|
+
security add-generic-password -a "oth-dev" -s "oth-mcp-username" -w
|
|
18
|
+
security add-generic-password -a "oth-dev" -s "oth-mcp-password" -w
|
|
15
19
|
```
|
|
16
20
|
|
|
17
|
-
**
|
|
21
|
+
**Environment variables** (works everywhere):
|
|
18
22
|
|
|
19
23
|
```bash
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
24
|
+
export OTH_USERNAME="your-username"
|
|
25
|
+
export OTH_PASSWORD="your-password"
|
|
26
|
+
export OTH_ENV="dev" # optional, defaults to dev
|
|
23
27
|
```
|
|
24
28
|
|
|
25
29
|
### 2. Add to Claude Code
|