主控程序
模型上下文协议(MCP)服务器 *主控程序* API
\[!重要\] 此MCP服务器尚未准备好用于生产。在发布到包管理器之前删除此通知。
总结
目录
安装
\[!提示\] 要完成将MCP服务器发布到npm和其他服务器,您必须 运行你的第一代动作.
部署于https://cloudinary-test-mcp-server.kanwar-a2e.workers.dev
DXT (Desktop Extension)
使用预构建的作为桌面扩展安装MCP服务器 mcp-server.dxt 文件:
只需拖放 mcp-server.dxt 将文件安装到Claude Desktop上以安装扩展。
DXT包包括MCP服务器和所有必要的配置。安装后,服务器将无需额外设置即可使用。
\[!注意\] DXT(桌面扩展)提供了一种简化的方式来打包和分发MCP服务器。更多了解 桌面扩展.
Cursor

或手动:
- 打开光标设置
- 选择工具和集成
- 选择新MCP服务器
- 如果配置文件为空,请将以下JSON粘贴到MCP服务器配置中:
{
"mcpServers": {
"SDK": {
"type": "mcp",
"url": "https://cloudinary-test-mcp-server.kanwar-a2e.workers.dev/mcp",
"headers": {
"x-cloudinary-auth": "${MCP_CLOUDINARY_AUTH}",
"x-oauth2": "${MCP_OAUTH2}"
}
}
}
}Claude Code CLI
claude mcp add --transport sse SDK https://cloudinary-test-mcp-server.kanwar-a2e.workers.dev/sse --header "x-cloudinary-auth: ..." --header "x-oauth2: ..."Windsurf
参见 官方Windsurf文档 获取最新信息
- 打开风帆设置
- 在左侧菜单中选择Cascade
- 点击
Manage MCPs(要管理MCP,您应该使用Windsurf帐户登录) - 点击
View raw config打开mcp配置文件。 - 如果配置文件为空,请粘贴完整的json
{
"mcpServers": {
"SDK": {
"type": "mcp",
"url": "https://cloudinary-test-mcp-server.kanwar-a2e.workers.dev/mcp",
"headers": {
"x-cloudinary-auth": "${MCP_CLOUDINARY_AUTH}",
"x-oauth2": "${MCP_OAUTH2}"
}
}
}
}VS Code
参见 官方VS Code文档 获取最新信息
- 打开 命令面板
- 搜索并打开
MCP: Open User Configuration。这应该会打开mcp.json文件 - 如果配置文件为空,请粘贴完整的json
{
"servers": {
"SDK": {
"type": "mcp",
"url": "https://cloudinary-test-mcp-server.kanwar-a2e.workers.dev/mcp",
"headers": {
"x-cloudinary-auth": "${env:MCP_CLOUDINARY_AUTH}",
"x-oauth2": "${env:MCP_OAUTH2}"
}
}
}
}Stdio installation via npm To start the MCP server, run:
npx mcp start --api-key ... --api-secret ... --oauth2 ... --cloud-name ...有关服务器参数的完整列表,请运行:
npx mcp --help发展
在本地运行,不使用已发布的npm包:
- 克隆此存储库
- 跑
npm install - 跑
npm run build - 跑
node ./bin/mcp-server.js start --api-key ... --api-secret ... --oauth2 ... --cloud-name ...
要将此本地版本与Cursor、Claude或其他MCP客户端一起使用,您需要添加以下配置:
{
"mcpServers": {
"SDK": {
"command": "node",
"args": [
"./bin/mcp-server.js",
"start",
"--api-key",
"...",
"--api-secret",
"...",
"--oauth2",
"...",
"--cloud-name",
"..."
]
}
}
}或者,要在本地调试MCP服务器,请使用官方的MCP检查器:
npx @modelcontextprotocol/inspector node ./bin/mcp-server.js start --api-key ... --api-secret ... --oauth2 ... --cloud-name ...贡献
虽然我们重视对此MCP服务器的贡献,但代码是以编程方式生成的。添加到内部文件的任何手动更改都将在下一代上被覆盖。 我们期待着您的反馈。请随时打开PR或带有概念证明的问题,我们将尽最大努力将其纳入未来的版本中。
