Skip to content

Commit a69cc86

Browse files
authored
docs: Describe how to use Docling MCP (#332)
Signed-off-by: Michele Dolfi <dol@zurich.ibm.com>
1 parent 624f65d commit a69cc86

File tree

2 files changed

+40
-0
lines changed

2 files changed

+40
-0
lines changed

docs/README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,5 +6,6 @@ This documentation pages explore the webserver configurations, runtime options,
66
- [Handling models](./models.md)
77
- [Usage](./usage.md)
88
- [Deployment](./deployment.md)
9+
- [MCP](./mcp.md)
910
- [Development](./development.md)
1011
- [`v1` migration](./v1_migration.md)

docs/mcp.md

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
# Docling MCP in Docling Serve
2+
3+
The `docling-serve` container image includes all MCP (Model Communication Protocol) features starting from version v1.1.0. To leverage these features, you simply need to use a different entrypoint—no custom image builds or additional installations are required. The image provides the `docling-mcp-server` executable, which enables MCP functionality out of the box as of version v1.1.0 ([changelog](https://github.com/docling-project/docling-serve/blob/624f65d41b734e8b39ff267bc8bf6e766c376d6d/CHANGELOG.md)).
4+
5+
Read more on [Docling MCP](https://github.com/docling-project/docling-mcp) in its dedicated repository.
6+
7+
## Launching the MCP Service
8+
9+
By default, the container runs `docling-serve run` and exposes port 5001. To start the MCP service, override the entrypoint and specify your desired port mapping. For example:
10+
11+
```sh
12+
podman run -p 8000:8000 quay.io/docling-project/docling-serve -- docling-mcp-server --transport streamable-http --port 8000 --host 0.0.0.0
13+
```
14+
15+
This command starts the MCP server on port 8000, accessible at `http://localhost:8000/mcp`. Adjust the port and host as needed. Key arguments for `docling-mcp-server` include `--transport streamable-http` (HTTP transport for client connections), `--port <PORT>`, and `--host <HOST>` (use `0.0.0.0` to accept connections from any interface).
16+
17+
## Configuring MCP Clients
18+
19+
Most MCP-compatible clients, such as LM Studio and Claude Desktop, allow you to specify custom MCP server endpoints. The standard configuration uses a JSON block to define available MCP servers. For example, to connect to the Docling MCP server running on port 8000:
20+
21+
```json
22+
{
23+
"mcpServers": {
24+
"docling": {
25+
"url": "http://localhost:8000/mcp"
26+
}
27+
}
28+
}
29+
```
30+
31+
Insert this configuration in your client's settings where MCP servers are defined. Update the URL if you use a different port.
32+
33+
### LM Studio and Claude Desktop
34+
35+
Both LM Studio and Claude Desktop support MCP endpoints via configuration files or UI settings. Paste the above JSON block into the appropriate configuration section. For Claude Desktop, add the MCP server in the "Custom Model" or "MCP Server" section. For LM Studio, refer to its documentation for the location of the MCP server configuration.
36+
37+
### Other MCP Clients
38+
39+
Other clients, such as Continue Coding Assistant, also support custom MCP endpoints. Use the same configuration pattern: provide the MCP server URL ending with `/mcp` and ensure the port matches your container setup. See the [Docling MCP docs](https://github.com/docling-project/docling-mcp/tree/main/docs/integrations) for more details.

0 commit comments

Comments
 (0)