开发文档
快速开始
欢迎使用SMCP Hub的MCP服务。本文档将帮助您快速上手我们的服务,开始构建智能应用。
使用我们的服务,您可以轻松地将大量外部工具的能力集成到您的应用中,无需自行构建和维护复杂的AI基础设施。
提示: 在开始之前,请确保您已经注册账号并获取API密钥。
安装与配置
您可以使用我们的SDK快速集成SMCP Hub的服务。目前只提供NodeJS和Python版本。
安装MCP客户端
NodeJS
npm install @smcphub/client
Python
pip install smcphub-client
安装MCP服务端
NPM
npm install @smcphub/server
Python
pip install smcphub-server
基本使用
具体使用方法,详见开发者工具。
认证与授权
在获取API密钥之前,需要先注册账号,登录后点击页面右上角的账号名称或者头像进去用户中心,然后进入我的API密钥页面创建API密钥即可。所有的MCP服务的调用都需要使用API密钥进行认证授权。请在API请求的头部包含您的API密钥。
获取API密钥
- 登录您的SMCP Hub账户
- 导航至用户中心的"管理API密钥"
- 进入“所有API密钥”页面,点击"创建API密钥"按钮
- 为您的密钥命名并选择适当的权限
- 创建完成后,您将看到您的API密钥(请妥善保管,它只会显示一次)
警告: 请勿在客户端代码中暴露您的API密钥。应该将密钥存储在服务器端,并通过安全的后端API调用我们的服务。
MCP客户端
完整的MCP客户端参考文档,包含所有方法、参数、响应格式等详细信息。适合用于自定义AI应用的开发,复制下面的安装命令直接安装到项目下面即可。
安装
使用npm或pip安装MCP客户端:
NPM
npm install @smcphub/client
Python
pip install smcphub-client
使用(NodeJS示例)
- connect(): 连接MCP服务端并获取所有工具列表
- callTool(name, parameters): 调用指定工具获取数据
- name: 工具名称
- parameters: 工具参数
参数:无
示例代码:
import SmcphubClient from '@smcphub/client';
const smcphubClient = new SmcphubClient({
api_key: 'your-api-key',
});
const tools = await smcphubClient.connect();
console.log(tools);
参数:
示例代码:
const tool_result = await smcphubClient.callTool('get_weather', {
city: '杭州'
});
console.log(tool_result);
MCP服务端
MCP服务端包含用户预购的所有工具集,服务端初始化时会自动加载所有工具集的工具。
集成到 Cursor 编辑器
MCP服务端可以集成到 Cursor 编辑器中,方便用户在编辑器中直接使用工具集。
安装
在 Cursor 编辑器中,点击右上角的“设置”按钮,然后在设置页面选择“MCP”,然后点击“添加新的MCP Server”按钮,再编辑配置文件mcp.json。
{
"mcpServers": {
"smcphub": {
"command": "npx",
"args": ["-y", "@smcphub/server"],
"env": {
"SMCPHUB_API_KEY": "您在新器集官网上申请的API密钥"
}
}
}
}
使用
安装完成后,返回设置界面,选择MCP,启用smcphub即可。
如何发布MCP服务
- 点击页面头部右上角的“快速发布MCP服务”按钮
- 或者进入用户中心的“MCP服务管理”,再进入“发布MCP服务”页面
如何配置MCP服务
进入用户中心的“MCP服务管理”,打开“我发布的”页面,然后再点击操作栏的配置图标。
如何部署MCP服务
进入用户中心的“MCP服务管理”,打开“我发布的”页面,然后再点击操作栏的云部署图标。