本地开发MCP Server+Cline配置使用

MCP 有以下几个核心功能:

  • Resources 资源
  • Prompts 提示词
  • Tools 工具
  • Sampling 采样
  • Roots 根目录
  • Transports 传输层

其中 MCP 的传输层支持了 2 种协议的实现:stdio(标准输入/输出)和 SSE(服务器发送事件),因为 stdio 更为常用,所以本文会以 stdio 为例。

MCP Python SDK (GitHub - modelcontextprotocol/python-sdk: The official Python SDK for Model Context Protocol servers and clients) 虽然提供了 uv 和pip这个包管理工具安装sdk,经过对比还是安装uv更方便些,使用uv启动MCP server会更加的容易。因此需要先安装uv。

一、安装uv

pip3 install uv

二、开发mcp server

参考官网:For Server Developers - Model Context Protocol

 1、初始化项目并安装依赖

# 初始化项目
uv init mymcp
cd mymcp

# 创建虚拟环境并进入虚拟环境
uv venv
source .venv/bin/activate

# 安装基本依赖
uv add "mcp[cli]"

# 注:在虚拟环境中安装依赖需要用uv,比如,uv add requests

2、创建服务脚本,并编写代码

#创建脚本
touch mymcp.py

编写代码,这里用最简单的加法计算为例

#mymcp.py
from mcp.server.fastmcp import FastMCP

mcp = FastMCP("Demo")# 这个Demo就是MCP Server的名字

@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    # print('...', file=sys.stderr)
    return a+b


if __name__ == "__main__":
    print("Starting MCP server...")
    mcp.run(transport='stdio')

3、调试服务

使用官方提供的 Inspector 可视化工具来调试我们的服务器。

#执行调试命令
#注意:如果本次开发完了,退出了,下次想重新调试,需要再source .venv/bin/activate下环境,才可以使用mcp dev
mcp dev mymcp.py

运行后,出现下图即为运行成功

 点击http://localhost:5173即可进入浏览器调试。按下图步骤即可进行调试:

三、Cline配置使用

开发完成后想要Claude Desktop访问,可以直接 mcp install server.py 安装,这种方式是用于Claude使用,Cline使用的话需要配置下。

1、配置

打开cline的mcp配置,将如下配置写入cline_mcp_setting.json中,若绿点亮了则表示成功。

"mymcp": {
   "command": "uv",
   "args": [
        "--directory",
        "/Users/xxx/xxxx/xxx/mymcp",
        "run",
        "mymcp.py"
   ],
   "disabled": false,
   "autoApprove": []
}

2、测试

配置成功后,cline中使用测试下

### 配置MCP Servers与Cline的方法 #### 1. 安装环境准备 为了成功配置MCP Servers和Cline,需要先安装必要的开发环境。以下是具体的准备工作: - **Node.js 和 npm**: 确保已安装 Node.js 及其包管理器 npm。可以通过命令 `node -v` 和 `npm -v` 来验证是否正确安装[^2]。 - **Python 环境**: MCP Server 的实现通常基于 Python,因此需要确保 Python 已经安装并可用。建议使用虚拟环境来隔离依赖项。 ```bash # 创建并激活虚拟环境 (可选) python3 -m venv env source env/bin/activate ``` #### 2. 编写MCP Server代码 按照提供的示例代码,创建一个名为 `mymcp.py` 的文件,并将其作为基础的 MCP Server 实现。 ```python from mcp.server.fastmcp import FastMCP mcp = FastMCP("Demo") # Demo 是 MCP Server 的名字 @mcp.tool() def add(a: int, b: int) -> int: """Add two numbers""" return a + b if __name__ == "__main__": print("Starting MCP server...") mcp.run(transport='stdio') ``` 上述代码定义了一个简单的加法函数 `add` 并注册到 MCP Server 中。启动该脚本即可运行服务器[^1]。 #### 3. 启动MCP Server 在终端中运行以下命令以启动 MCP Server: ```bash python mymcp.py ``` 这将在标准输入输出模式下启动服务器,等待来自客户端的任务请求。 #### 4. 配置Cline插件 Cline 插件用于通过 MCP 协议与服务器通信。以下是具体步骤: - **安装 TypeScript 版本的 Cline**: ```bash npm install -g @mcp/cli-typescript ``` 此命令会全局安装 MCP-TypeScript CLI 工具。 - **初始化项目**: 进入工作目录后,执行以下命令以初始化一个新的 TypeScript 项目: ```bash mcp init --typescript ``` 这将生成默认的项目结构以及所需的配置文件。 - **修改配置文件**: 编辑项目的 `config.json` 文件,指定本地 MCP Server 的地址和服务名称。例如: ```json { "server": { "address": "localhost", "port": 8080, "service_name": "Demo" } } ``` 注意:如果使用的是 `stdio` 模式的传输方式,则无需显式设置端口。 #### 5. 调试服务 完成以上配置后,可以在 VS Code 或其他支持的 IDE 中进行调试测试。确保以下条件满足: - MCP Server 正常运行。 - Cline 插件能够连接至指定的服务地址。 尝试调用 `add` 方法以验证功能正常: ```javascript const result = await client.call('add', { a: 5, b: 7 }); console.log(result); // 输出应为 12 ``` --- ###
评论 13
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值