使用说明
🧠 MCP 服务器 – 安装指南
本指南将引导您完成自定义设置并进行连接 MCP服务器 (例如,一个请假管理或系统自动化服务器)与 克劳德桌面版。
🚀 设置步骤
1. 安装Claude桌面版
下载并安装 Claude Desktop(可译为“Claude桌面版”或保持原样,具体根据语境决定是否需要意译) 来自 Anthropic的官方网站。
2. 安装 uv
在终端中运行以下命令进行安装 紫外线:
pip install uv
3. 初始化一个新的MCP服务器项目
使用以下命令创建一个新项目目录:
uv init my-first-mcp-server
4. 将MCP CLI添加到您的项目中
在项目目录中,运行:
uv add "mcp[cli]"
💡 这会安装MCP CLI,以便您能够使用Claude注册和管理服务器。
5. (可选)修复类型错误
如果你遇到与typer相关的类型错误,请使用以下命令进行升级:
pip install --upgrade typer
6. 编写您的MCP服务器代码
编辑 main.py 文件并实现你的逻辑—— 例如,一个处理请假审批请求的请假管理服务器,或者一个能够执行如调整亮度或打开设置等操作的系统自动化服务器。
示例 main.py 结构:
from mcp.server.fastmcp import FastMCP
mcp = FastMCP("Demo")
@mcp.tool()
def set_brightness(percent: int) -> str:
"""Set screen brightness to a specific percentage."""
# Example: OS-specific brightness logic goes here
return f"Brightness set to {percent}%"
@mcp.tool()
def open_settings() -> str:
"""Open system settings."""
# Example: open settings using platform module
return "Settings opened successfully"
if __name__ == "__main__":
mcp.run()
7. 将服务器安装到Claude桌面
在您的项目目录中,运行:
uv run mcp install main.py
🧩 此命令将您的服务器注册到Claude,以便其工具可以在应用程序中使用。
8. 重启Claude桌面版
从任务管理器中结束所有正在运行的Claude实例,然后重新启动Claude Desktop。
9. 验证安装
打开Claude桌面版——现在你应该在界面中看到由你的MCP服务器提供的工具列表。
💬 示例提示
以下是一些示例自然语言提示,您可以在安装MCP服务器后,在Claude Desktop中使用。
🖥️ 系统自动化服务器
- “将我的屏幕亮度调高到80%。”
- “将亮度设置为50%。”
- “打开系统设置。”
- “把亮度调到30%。”
- “你能帮我检查并调整一下显示屏的亮度吗?”
行李管理服务器(或:行李处理系统服务器)
- “从明天开始申请两天假期。”
- “给我看看我剩下的假期余额。”
- “取消我上次的请假申请。”
- “列出本月所有已批准的休假。”
✅ 你准备好了!
您的MCP服务器现已安装并成功与Claude集成。 您可以在Claude Desktop中直接通过自然语言提示开始使用其工具。
🧩 可选提示
- 使用
uv run main.py在安装之前,先对您的服务器进行独立测试。 - 要卸载或重新安装,请重新运行
uv run mcp install main.py. - 您可以为不同的自动化领域(例如,媒体控制、生产力、系统工具)创建多个MCP服务器。