docs2ai 0.1.1 → 0.1.3
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 +44 -0
- package/dist/cli.mjs +591 -92
- package/dist/cli.mjs.map +1 -1
- package/package.json +5 -2
package/README.md
CHANGED
|
@@ -39,6 +39,50 @@ docs2ai list # show configured sources
|
|
|
39
39
|
- **YAML frontmatter** — each output includes source URL, fetch date, platform, and title
|
|
40
40
|
- **Config file** — manage multiple doc sources with `.docs2ai.yaml`
|
|
41
41
|
- **Playwright optional** — uses fast static fetch by default, Playwright only when needed for JS-rendered pages
|
|
42
|
+
- **MCP server** — expose fetched docs to AI tools (Claude Code, Cursor) via Model Context Protocol
|
|
43
|
+
|
|
44
|
+
## MCP Server
|
|
45
|
+
|
|
46
|
+
Once you've crawled documentation, `docs2ai serve` starts an MCP server that lets AI coding tools query your docs directly.
|
|
47
|
+
|
|
48
|
+
### Quick start
|
|
49
|
+
|
|
50
|
+
```bash
|
|
51
|
+
# 1. Crawl some docs
|
|
52
|
+
docs2ai https://docs.stripe.com/api/charges --crawl --name stripe
|
|
53
|
+
|
|
54
|
+
# 2. Start the MCP server
|
|
55
|
+
docs2ai serve
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
### Claude Code
|
|
59
|
+
|
|
60
|
+
Add to `.mcp.json` in your project root:
|
|
61
|
+
|
|
62
|
+
```json
|
|
63
|
+
{
|
|
64
|
+
"mcpServers": {
|
|
65
|
+
"docs2ai": {
|
|
66
|
+
"command": "npx",
|
|
67
|
+
"args": ["docs2ai", "serve", "-d", ".ai/docs/"]
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
Claude Code will then have access to 4 tools:
|
|
74
|
+
|
|
75
|
+
- **`list_sources`** — see all available documentation sources
|
|
76
|
+
- **`list_pages`** — list pages within a source
|
|
77
|
+
- **`read_page`** — read the full markdown content of a page
|
|
78
|
+
- **`search_docs`** — full-text search across all docs
|
|
79
|
+
|
|
80
|
+
### Options
|
|
81
|
+
|
|
82
|
+
```bash
|
|
83
|
+
docs2ai serve # serves .ai/docs/ (default)
|
|
84
|
+
docs2ai serve -d ./docs/ # custom directory
|
|
85
|
+
```
|
|
42
86
|
|
|
43
87
|
## Config (.docs2ai.yaml)
|
|
44
88
|
|