Docs: mcp update, uv in dockerfile template (#1284)

droserasprout · web-flow · commit 06c89834bbb1 · 2025-09-29T14:37:14.000-03:00
* Add uv dockerfile template

* Update MCP page
diff --git a/docs/5.advanced/8.mcp.md b/docs/5.advanced/8.mcp.md
@@ -14,14 +14,6 @@ description: "MCP is an open protocol that standardizes how applications provide
 - Custom tools can be implemented for project-specific functionality
 ::
 
-::banner{type="warning"}
-**You are early!**
-
-<br>
-
-MCP is a relatively recent technology, so many tools might not work as expected. Consult the [Known issues](#known-issues) section for more information and open the ticket in [GitHub issues](https://github.com/dipdup-io/dipdup/issues) if you encounter any problems.
-::
-
 ## Introduction
 
 The **Model Context Protocol** (MCP) is an open protocol that enables seamless integration between LLM applications and external data sources and tools. Whether you're building an AI-powered IDE, enhancing a chat interface, or creating custom AI workflows, MCP provides a standardized way to connect LLMs with the context they need.
@@ -67,8 +59,6 @@ The DipDup MCP server can be connected to various MCP-compatible clients. Here's
 
 ### VSCode (Copilot)
 
-Support for MCP is available since [1.99 release](https://code.visualstudio.com/updates/v1_99) (March 2025) of VSCode.
-
 See [Use agent mode in VS Code](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode) page.
 
 Add the following definition to the `.vscode/mcp.json` file:
@@ -115,13 +105,7 @@ If your server is running, but Cursor doesn't connect, try "Reload Window" in th
 
 ### Claude Desktop
 
-[Claude Desktop](https://claude.ai/download) currently only supports stdio-based MCP servers. You can use [supercorp-ai/supergateway](https://github.com/supercorp-ai/supergateway) tool to connect DipDup MCP server to Claude Desktop:
-
-```shell [Terminal]
-pnpx supergateway --sse http://127.0.0.1:9999
-```
-
-There is also [lightconetech/mcp-gateway](https://github.com/lightconetech/mcp-gateway) tool available for the same purpose.
+See the page in official [Claude Desktop documentation](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp) to configure MCP.
 
 ## Implementing MCP primitives
 
@@ -233,14 +217,6 @@ logging:
   '': DEBUG
 ```
 
-## Known issues
-
-- **Claude Desktop** doesn't support SSE-based MCP servers; gateway tools are required.
-- **Cursor** fails to discover resources exposed by DipDup server. Tools work fine. (0.47.8 tested)
-- **DipDup** doesn't support custom prompts at the moment.
-- **DipDup** `mcp run` command doesn't exit gracefully on SIGINT.
-- **VSCode** doesn't support MCP resources and prompts yet.
-
 ## Further reading
 
 - [For Server Developers - Model Context Protocol](https://modelcontextprotocol.io/quickstart/server) - Official guide for implementing MCP servers.
diff --git a/src/demo_blank/deploy/Dockerfile b/src/demo_blank/deploy/Dockerfile
@@ -5,9 +5,10 @@ FROM dipdup/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:next
 
-#### Uncomment lines below if your project requires additional dependencies 
+#### Uncomment lines below if your project requires additional dependencies
+# COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 # COPY --chown=dipdup pyproject.toml README.md .
-# RUN pip install .
+# RUN uv pip install .
 
 #### Uncomment if you have implemented a custom CLI command (see Services in docs)
 # ENTRYPOINT ["python", "-m", "demo_blank"]
diff --git a/src/demo_evm_events/deploy/Dockerfile b/src/demo_evm_events/deploy/Dockerfile
@@ -5,9 +5,10 @@ FROM dipdup/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:next
 
-#### Uncomment lines below if your project requires additional dependencies 
+#### Uncomment lines below if your project requires additional dependencies
+# COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 # COPY --chown=dipdup pyproject.toml README.md .
-# RUN pip install .
+# RUN uv pip install .
 
 #### Uncomment if you have implemented a custom CLI command (see Services in docs)
 # ENTRYPOINT ["python", "-m", "demo_evm_events"]
diff --git a/src/demo_evm_transactions/deploy/Dockerfile b/src/demo_evm_transactions/deploy/Dockerfile
@@ -5,9 +5,10 @@ FROM dipdup/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:next
 
-#### Uncomment lines below if your project requires additional dependencies 
+#### Uncomment lines below if your project requires additional dependencies
+# COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 # COPY --chown=dipdup pyproject.toml README.md .
-# RUN pip install .
+# RUN uv pip install .
 
 #### Uncomment if you have implemented a custom CLI command (see Services in docs)
 # ENTRYPOINT ["python", "-m", "demo_evm_transactions"]
diff --git a/src/demo_evm_uniswap/deploy/Dockerfile b/src/demo_evm_uniswap/deploy/Dockerfile
@@ -5,9 +5,10 @@ FROM dipdup/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:next
 
-#### Uncomment lines below if your project requires additional dependencies 
+#### Uncomment lines below if your project requires additional dependencies
+# COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 # COPY --chown=dipdup pyproject.toml README.md .
-# RUN pip install .
+# RUN uv pip install .
 
 #### Uncomment if you have implemented a custom CLI command (see Services in docs)
 # ENTRYPOINT ["python", "-m", "demo_evm_uniswap"]
diff --git a/src/demo_starknet_events/deploy/Dockerfile b/src/demo_starknet_events/deploy/Dockerfile
@@ -5,9 +5,10 @@ FROM dipdup/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:next
 
-#### Uncomment lines below if your project requires additional dependencies 
+#### Uncomment lines below if your project requires additional dependencies
+# COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 # COPY --chown=dipdup pyproject.toml README.md .
-# RUN pip install .
+# RUN uv pip install .
 
 #### Uncomment if you have implemented a custom CLI command (see Services in docs)
 # ENTRYPOINT ["python", "-m", "demo_starknet_events"]
diff --git a/src/demo_substrate_events/deploy/Dockerfile b/src/demo_substrate_events/deploy/Dockerfile
@@ -5,9 +5,10 @@ FROM dipdup/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:next
 
-#### Uncomment lines below if your project requires additional dependencies 
+#### Uncomment lines below if your project requires additional dependencies
+# COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 # COPY --chown=dipdup pyproject.toml README.md .
-# RUN pip install .
+# RUN uv pip install .
 
 #### Uncomment if you have implemented a custom CLI command (see Services in docs)
 # ENTRYPOINT ["python", "-m", "demo_substrate_events"]
diff --git a/src/demo_tezos_auction/deploy/Dockerfile b/src/demo_tezos_auction/deploy/Dockerfile
@@ -5,9 +5,10 @@ FROM dipdup/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:next
 
-#### Uncomment lines below if your project requires additional dependencies 
+#### Uncomment lines below if your project requires additional dependencies
+# COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 # COPY --chown=dipdup pyproject.toml README.md .
-# RUN pip install .
+# RUN uv pip install .
 
 #### Uncomment if you have implemented a custom CLI command (see Services in docs)
 # ENTRYPOINT ["python", "-m", "demo_tezos_auction"]
diff --git a/src/demo_tezos_dao/deploy/Dockerfile b/src/demo_tezos_dao/deploy/Dockerfile
@@ -5,9 +5,10 @@ FROM dipdup/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:next
 
-#### Uncomment lines below if your project requires additional dependencies 
+#### Uncomment lines below if your project requires additional dependencies
+# COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 # COPY --chown=dipdup pyproject.toml README.md .
-# RUN pip install .
+# RUN uv pip install .
 
 #### Uncomment if you have implemented a custom CLI command (see Services in docs)
 # ENTRYPOINT ["python", "-m", "demo_tezos_dao"]
diff --git a/src/demo_tezos_dex/deploy/Dockerfile b/src/demo_tezos_dex/deploy/Dockerfile
@@ -5,9 +5,10 @@ FROM dipdup/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:next
 
-#### Uncomment lines below if your project requires additional dependencies 
+#### Uncomment lines below if your project requires additional dependencies
+# COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 # COPY --chown=dipdup pyproject.toml README.md .
-# RUN pip install .
+# RUN uv pip install .
 
 #### Uncomment if you have implemented a custom CLI command (see Services in docs)
 # ENTRYPOINT ["python", "-m", "demo_tezos_dex"]
diff --git a/src/demo_tezos_domains/deploy/Dockerfile b/src/demo_tezos_domains/deploy/Dockerfile
@@ -5,9 +5,10 @@ FROM dipdup/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:next
 
-#### Uncomment lines below if your project requires additional dependencies 
+#### Uncomment lines below if your project requires additional dependencies
+# COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 # COPY --chown=dipdup pyproject.toml README.md .
-# RUN pip install .
+# RUN uv pip install .
 
 #### Uncomment if you have implemented a custom CLI command (see Services in docs)
 # ENTRYPOINT ["python", "-m", "demo_tezos_domains"]
diff --git a/src/demo_tezos_etherlink/deploy/Dockerfile b/src/demo_tezos_etherlink/deploy/Dockerfile
@@ -3,7 +3,7 @@ FROM dipdup/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:next
 
 # COPY --chown=dipdup pyproject.toml README.md .
-# RUN pip install .
+# RUN uv pip install .
 
 COPY --chown=dipdup . demo_tezos_etherlink
 WORKDIR demo_tezos_etherlink
diff --git a/src/demo_tezos_events/deploy/Dockerfile b/src/demo_tezos_events/deploy/Dockerfile
@@ -5,9 +5,10 @@ FROM dipdup/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:next
 
-#### Uncomment lines below if your project requires additional dependencies 
+#### Uncomment lines below if your project requires additional dependencies
+# COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 # COPY --chown=dipdup pyproject.toml README.md .
-# RUN pip install .
+# RUN uv pip install .
 
 #### Uncomment if you have implemented a custom CLI command (see Services in docs)
 # ENTRYPOINT ["python", "-m", "demo_tezos_events"]
diff --git a/src/demo_tezos_factories/deploy/Dockerfile b/src/demo_tezos_factories/deploy/Dockerfile
@@ -5,9 +5,10 @@ FROM dipdup/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:next
 
-#### Uncomment lines below if your project requires additional dependencies 
+#### Uncomment lines below if your project requires additional dependencies
+# COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 # COPY --chown=dipdup pyproject.toml README.md .
-# RUN pip install .
+# RUN uv pip install .
 
 #### Uncomment if you have implemented a custom CLI command (see Services in docs)
 # ENTRYPOINT ["python", "-m", "demo_tezos_factories"]
diff --git a/src/demo_tezos_head/deploy/Dockerfile b/src/demo_tezos_head/deploy/Dockerfile
@@ -5,9 +5,10 @@ FROM dipdup/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:next
 
-#### Uncomment lines below if your project requires additional dependencies 
+#### Uncomment lines below if your project requires additional dependencies
+# COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 # COPY --chown=dipdup pyproject.toml README.md .
-# RUN pip install .
+# RUN uv pip install .
 
 #### Uncomment if you have implemented a custom CLI command (see Services in docs)
 # ENTRYPOINT ["python", "-m", "demo_tezos_head"]
diff --git a/src/demo_tezos_nft_marketplace/deploy/Dockerfile b/src/demo_tezos_nft_marketplace/deploy/Dockerfile
@@ -5,9 +5,10 @@ FROM dipdup/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:next
 
-#### Uncomment lines below if your project requires additional dependencies 
+#### Uncomment lines below if your project requires additional dependencies
+# COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 # COPY --chown=dipdup pyproject.toml README.md .
-# RUN pip install .
+# RUN uv pip install .
 
 #### Uncomment if you have implemented a custom CLI command (see Services in docs)
 # ENTRYPOINT ["python", "-m", "demo_tezos_nft_marketplace"]
diff --git a/src/demo_tezos_raw/deploy/Dockerfile b/src/demo_tezos_raw/deploy/Dockerfile
@@ -5,9 +5,10 @@ FROM dipdup/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:next
 
-#### Uncomment lines below if your project requires additional dependencies 
+#### Uncomment lines below if your project requires additional dependencies
+# COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 # COPY --chown=dipdup pyproject.toml README.md .
-# RUN pip install .
+# RUN uv pip install .
 
 #### Uncomment if you have implemented a custom CLI command (see Services in docs)
 # ENTRYPOINT ["python", "-m", "demo_tezos_raw"]
diff --git a/src/demo_tezos_token/deploy/Dockerfile b/src/demo_tezos_token/deploy/Dockerfile
@@ -5,9 +5,10 @@ FROM dipdup/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:next
 
-#### Uncomment lines below if your project requires additional dependencies 
+#### Uncomment lines below if your project requires additional dependencies
+# COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 # COPY --chown=dipdup pyproject.toml README.md .
-# RUN pip install .
+# RUN uv pip install .
 
 #### Uncomment if you have implemented a custom CLI command (see Services in docs)
 # ENTRYPOINT ["python", "-m", "demo_tezos_token"]
diff --git a/src/demo_tezos_token_balances/deploy/Dockerfile b/src/demo_tezos_token_balances/deploy/Dockerfile
@@ -5,9 +5,10 @@ FROM dipdup/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:next
 
-#### Uncomment lines below if your project requires additional dependencies 
+#### Uncomment lines below if your project requires additional dependencies
+# COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 # COPY --chown=dipdup pyproject.toml README.md .
-# RUN pip install .
+# RUN uv pip install .
 
 #### Uncomment if you have implemented a custom CLI command (see Services in docs)
 # ENTRYPOINT ["python", "-m", "demo_tezos_token_balances"]
diff --git a/src/demo_tezos_token_transfers/deploy/Dockerfile b/src/demo_tezos_token_transfers/deploy/Dockerfile
@@ -5,9 +5,10 @@ FROM dipdup/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:8
 # FROM ghcr.io/dipdup-io/dipdup:next
 
-#### Uncomment lines below if your project requires additional dependencies 
+#### Uncomment lines below if your project requires additional dependencies
+# COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 # COPY --chown=dipdup pyproject.toml README.md .
-# RUN pip install .
+# RUN uv pip install .
 
 #### Uncomment if you have implemented a custom CLI command (see Services in docs)
 # ENTRYPOINT ["python", "-m", "demo_tezos_token_transfers"]
diff --git a/src/dipdup/projects/base/deploy/Dockerfile.j2 b/src/dipdup/projects/base/deploy/Dockerfile.j2
@@ -5,9 +5,10 @@ FROM dipdup/dipdup:{{ project.dipdup_version }}
 # FROM ghcr.io/dipdup-io/dipdup:{{ project.dipdup_version }}
 # FROM ghcr.io/dipdup-io/dipdup:next
 
-#### Uncomment lines below if your project requires additional dependencies 
+#### Uncomment lines below if your project requires additional dependencies
+# COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 # COPY --chown=dipdup pyproject.toml README.md .
-# RUN pip install .
+# RUN uv pip install .
 
 #### Uncomment if you have implemented a custom CLI command (see Services in docs)
 # ENTRYPOINT ["python", "-m", "{{ project.package }}"]
