> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/zhong-wen-fan-ti/advanced-basic/mcp/install.md).

# MCP 環境安裝

首次使用 MCP 之前，需要安裝兩個底層工具：**uv** 同 **bun**。絕大多數 MCP Server 都依賴其中一個嚟啟動。

> 推薦先睇 [MCP 使用教程總覽](/docs/zhong-wen-fan-ti/advanced-basic/mcp.md)。

唔需要了解 uv / bun 嘅技術細節，Cherry Studio 會**自動完成下載同安裝**，只需喺介面入面撳對應按鈕。

## 自動安裝（推薦）

{% hint style="warning" %}
Cherry Studio 用嘅係 **自己內置嘅** [uv](https://github.com/astral-sh/uv) 同 [bun](https://github.com/oven-sh/bun)，唔會重用你部電腦入面可能已經裝過嘅版本。所以就算你系統入面已經有 uv / bun，都仍然需要跟住下面步驟再裝多一次畀 Cherry Studio 用。
{% endhint %}

喺 `設定 - MCP 伺服器` 入面，撳 `安裝` 按鈕，即可自動下載同安裝。因為係直接從 GitHub 上下載，速度可能會比較慢，而且好大機會失敗。安裝成功與否，以下面提到嘅資料夾入面有冇檔案為準。

<figure><img src="/files/89925f3d9336605d2dd38751462275e51ac92ac2" alt=""><figcaption></figcaption></figure>

**可執行程式安裝目錄：**

{% tabs %}
{% tab title="Windows" %}
`C:\Users\用戶名\.cherrystudio\bin`
{% endtab %}

{% tab title="macOS / Linux" %}
`~/.cherrystudio/bin`
{% endtab %}
{% endtabs %}

<figure><img src="/files/29710ed425093232d3c5218b3d63c320df4860a6" alt=""><figcaption><p>bin 目錄</p></figcaption></figure>

**如果無法正常安裝：**

可以將系統入面相對應嘅命令用軟連結方式連過嚟呢度，如果冇對應目錄，就需要手動建立。亦可以手動下載可執行檔放喺呢個目錄下面：

Bun: <https://github.com/oven-sh/bun/releases>\
UV: <https://github.com/astral-sh/uv/releases>

***

### 💡 獲取幫助同提交反饋

如果您喺配置或使用過程中遇到任何疑問、Bug 或有功能改進建議，請參考 [反饋同建議](/docs/zhong-wen-fan-ti/question-contact/suggestions.md) 入面提供嘅官方渠道。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/zhong-wen-fan-ti/advanced-basic/mcp/install.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.