@cyborg-sdk/mcp

MCP server for the Cyborg platform - documentation generation and sync.

Overview

This MCP server enables AI tool users to generate, upload, and sync documentation with the Cyborg backend. The AI writes readable markdown docs, users can review/edit, and the backend handles chunking and vectorization.

Installation

$3

Add to your ~/.claude/mcp.json:

``json
{
"mcpServers": {
"cyborg": {
"command": "npx",
"args": ["@cyborg-sdk/mcp"],
"env": {
"CYBORG_PUBLISHABLE_KEY": "cpk_live_xxx",
"CYBORG_API_URL": "https://api.cyborg.dev"
}
}
}
}
`

> Note: CYBORG_API_URL is optional - defaults to https://api.cyborg.dev

$3

Add to your Cursor MCP settings:

`json
{
"mcpServers": {
"cyborg": {
"command": "npx",
"args": ["@cyborg-sdk/mcp"],
"env": {
"CYBORG_PUBLISHABLE_KEY": "cpk_live_xxx",
"CYBORG_API_URL": "https://api.cyborg.dev"
}
}
}
}
`

> Note: CYBORG_API_URL is optional - defaults to https://api.cyborg.dev

Configuration

$3

| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| CYBORG_PUBLISHABLE_KEY | Yes* | - | Cyborg publishable key for authentication |
| CYBORG_API_URL | No | https://api.cyborg.dev | Backend API URL |

*Publishable key can also be passed as a tool parameter instead of environment variable.

$3

Publishable key is resolved in this order:
1. Tool parameter - Pass publishableKey directly to any tool
2. Environment variable - Set CYBORG_PUBLISHABLE_KEY in MCP config

Tools

$3

Initial upload of documentation files to the Cyborg backend.

Parameters:
- publishableKey (optional) - Cyborg publishable key
- docsDir (default: ./cyborg-docs) - Documentation directory
- documentType (default: markdown) - Document type (markdown or text)
- metadata (optional) - Project metadata (name, version)

Example:
`
Upload my docs from ./cyborg-docs
`

$3

Detect changes and sync with the backend.

Parameters:
- publishableKey (optional) - Cyborg publishable key
- docsDir (default: ./cyborg-docs) - Documentation directory
- dryRun (default: false) - Preview changes without uploading

Example:
`
Sync my documentation changes
`

$3

Update a single document in the backend.

Parameters:
- publishableKey (optional) - Cyborg publishable key
- path - Relative file path (e.g., api/useChat.md)
- docsDir (default: ./cyborg-docs) - Documentation directory

Example:
`
Update the api/useChat.md file in the backend
`

$3

Delete a document from the backend.

Parameters:
- publishableKey (optional) - Cyborg publishable key
- path - Relative file path to delete
- docsDir (default: ./cyborg-docs) - Documentation directory
- deleteLocalFile (default: false) - Also delete the local file

Example:
`
Delete api/deprecated.md from the backend
`

Resources

$3

List all documentation files in the output directory.

$3

Read a specific documentation file.

$3

Show sync status of documentation files:
- synced - Files up to date with backend
- modified - Files changed locally
- untracked - New files not uploaded
- deleted - Files deleted locally but still in backend

Prompts

$3

Interactive prompt that guides you through generating documentation tailored to your audience. It will ask about:

1. Product description
2. Target audience
3. Technical level
4. Main features
5. Common tasks
6. Documentation style
7. Existing docs

Then analyze your codebase and generate appropriate documentation.

Output Structure

Generated documentation follows this structure:

`
cyborg-docs/
├── getting-started.md
├── api/
│ ├── useChat.md
│ └── sendMessage.md
├── components/
│ └── ChatProvider.md
├── types/
│ └── Message.md
└── guides/
└── customization.md
`

State Tracking

After upload, state is saved to .cyborg-docs/.cyborg-state.json:

`json
{
"apiUrl": "https://api.cyborg.dev",
"projectId": "proj_abc123",
"lastSyncedAt": "2025-11-30T12:00:00Z",
"files": {
"getting-started.md": {
"documentId": "doc_xyz789",
"contentHash": "sha256:abc123...",
"syncedAt": "2025-11-30T12:00:00Z"
}
}
}
`

Workflow

$3

1. Generate documentation:
`
Generate documentation for this project
`

2. Review and edit the generated files in ./cyborg-docs/

3. Upload to Cyborg:
`
Upload my docs with publishable key cpk_live_xxx
`

$3

1. Make changes to your code

2. Regenerate affected docs:
`
Update the useChat hook documentation
`

3. Sync changes:
`
Sync my documentation
`

$3

`
What's the status of my docs?
`

Development

`bash


Install dependencies

npm install

Build

npm run build

Watch mode

npm run dev

Type check

npm run type-check
``

License

MIT