学习MCP

最新推荐文章于 2025-10-27 09:56:28 发布

原创最新推荐文章于 2025-10-27 09:56:28 发布 · 1.5k 阅读

54 ·

CC 4.0 BY-SA版权

文章标签：

#学习

前置知识

通讯方式：stdio

stdio：standard input and output 标准输入输出

process.stdout.write(process.pid + '\n') // 标准输出流

process.stdin.on('data', data=>{ // 标准输入流的监听
const resp = `回复：${data}\n`

process.stdout.write(resp)

})

通信格式：JSON-RPC

request

{

"jsonrpc": "2.0",

"method": "sum",

"params": {

"a": 5,

"b": 6

},

"id": 1,
}

response

{
"jsonrpc": "2.0",

"result": 11,

"id": 1,
}

MCP

MCP是一套标准协议，它规定了应用程序之间如何通信

如何通信：

1、通信方式：

stdio：推荐，高效，简洁，本地

http：可远程

2、通信格式：基于JSON-RPC的进一步规范

官网地址：https://modelcontextprotocol.io/

基本规范

1、初始化 initialize

request

{

"jsonrpc": "2.0",

"id": 1,

"method": "initialize", //固定为 initialize

"params":{

"protocolVersion": "2025-06-18", // MCP版本从官网Specification这个里面获取

"capabilities":{

"roots":{

"listChanged": true

                        }

                } ,

"sampling": {},

"elicitation": {}

        },
"clientInfo": { // 告知服务器客户端的信息

"name": "ExampleClient",
                 "title": "Example Client Display Name",

                 "version": "1.0.0",

        }

}

response

{

"jsonrpc": "2.0",

"id": 1,

"result":{

"protocolVersion": "2025-06-18", // MCP版本从官网Specification这个里面获取

"capabilities":{ // 代表服务器有哪些功能

"logging":{},

"prompts":{

"listChanged": true

                        },

"resources":{

"subscribe": true,

"listChanged": true

},
"tools":{

                                "listChanged": true

                        }

                } ,

                "serverInfo": { // 服务端信息

        "name": "ExampleServer",
                         "title": "Example Server Display Name",

                         "version": "1.0.0",

                },
"instructions": "Optional instructions for the client"

}

}

2、工具发现 tools/list

服务器有哪些工具函数可以提供客户端调用

request

{

"jsonrpc": "2.0",

"id": 1,

"method": "tools/list",

"params": {}
}

response

{

"jsonrpc": "2.0",

"id": 1,

"result":{

"tools": [
{

"name": "get_weather"
"title": "Weather Information Provider"

"description": "Get current weather information for a location",

"inputSchema": {
"type": "object",

"properties": {

"location": {

"type": "string",
"description":" City name or zip"

                                                }

                                        },

"required": ["location"]
                                }

                        }
                ]

}

}

3、工具调用 tools/call

request

{

"jsonrpc": "2.0",

        "id": 1,

"method": "tools/call", //工具调用

"params": {

"name": "get_weather", // 工具名，对应工具发现中的name

"arguments": { // 工具参数，需要和工具发现中的结构一致
"location": "New York"
                }

        }
}

response

{

"jsonrpc": "2.0",

"id": 1,

"result":{

"content": [ // 函数结果需要放到 content 字段中，如果有多个，使用数据
{

// 函数结果的类型

// 支持的类型

// https://modelcontextprotocol.io/specification/2025-06-18/server/tools#tool-result

"type": 'text',
"text": "72°F"

}
]

}

}