Hunter Bown
88 lines
2.2 KiB
Markdown
88 lines
2.2 KiB
Markdown
# MCP (External Tool Servers)
|
||
|
||
DeepSeek CLI can load additional tools via MCP (Model Context Protocol). MCP servers are local processes that the CLI starts and communicates with over stdio.
|
||
|
||
## Bootstrap MCP Config
|
||
|
||
Create a starter MCP config at your resolved MCP path:
|
||
|
||
```bash
|
||
deepseek mcp init
|
||
```
|
||
|
||
`deepseek setup --mcp` performs the same MCP bootstrap alongside skills setup.
|
||
|
||
## Config File Location
|
||
|
||
Default path:
|
||
|
||
- `~/.deepseek/mcp.json`
|
||
|
||
Overrides:
|
||
|
||
- Config: `mcp_config_path = "/path/to/mcp.json"`
|
||
- Env: `DEEPSEEK_MCP_CONFIG=/path/to/mcp.json`
|
||
|
||
`deepseek mcp init` (and `deepseek setup --mcp`) writes to this resolved path.
|
||
|
||
After editing the file, restart the TUI.
|
||
|
||
## Tool Naming
|
||
|
||
Discovered MCP tools are exposed to the model as:
|
||
|
||
- `mcp_<server>_<tool>`
|
||
|
||
Example: a server named `git` with a tool named `status` becomes `mcp_git_status`.
|
||
|
||
## Resource and Prompt Helpers
|
||
|
||
The CLI also exposes helper tools when MCP is enabled:
|
||
|
||
- `list_mcp_resources` (optional `server` filter)
|
||
- `list_mcp_resource_templates` (optional `server` filter)
|
||
- `mcp_read_resource` / `read_mcp_resource` (aliases)
|
||
- `mcp_get_prompt`
|
||
|
||
## Minimal Example
|
||
|
||
```json
|
||
{
|
||
"timeouts": {
|
||
"connect_timeout": 10,
|
||
"execute_timeout": 60,
|
||
"read_timeout": 120
|
||
},
|
||
"servers": {
|
||
"example": {
|
||
"command": "node",
|
||
"args": ["./path/to/your-mcp-server.js"],
|
||
"env": {},
|
||
"disabled": false
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
You can also use `mcpServers` instead of `servers` for compatibility with other clients.
|
||
|
||
## Server Fields
|
||
|
||
Per-server settings:
|
||
|
||
- `command` (string, required)
|
||
- `args` (array of strings, optional)
|
||
- `env` (object, optional)
|
||
- `connect_timeout`, `execute_timeout`, `read_timeout` (seconds, optional)
|
||
- `disabled` (bool, optional)
|
||
|
||
## Safety Caveat (Important)
|
||
|
||
MCP tools currently execute without TUI approval prompts. Only configure MCP servers you trust, and treat MCP server configuration as equivalent to running code on your machine.
|
||
|
||
## Troubleshooting
|
||
|
||
- Run `deepseek doctor` to confirm the MCP config path it resolved and whether it exists.
|
||
- If the MCP config is missing, run `deepseek mcp init --force` to regenerate it.
|
||
- If tools don’t appear, verify the server command works from your shell and that the server supports MCP `tools/list`.
|