开发文档

快速开始

欢迎使用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密钥

  1. 登录您的SMCP Hub账户
  2. 导航至用户中心的"管理API密钥"
  3. 进入“所有API密钥”页面，点击"创建API密钥"按钮
  4. 为您的密钥命名并选择适当的权限
  5. 创建完成后，您将看到您的API密钥（请妥善保管，它只会显示一次）
警告： 请勿在客户端代码中暴露您的API密钥。应该将密钥存储在服务器端，并通过安全的后端API调用我们的服务。

MCP客户端

完整的MCP客户端参考文档，包含所有方法、参数、响应格式等详细信息。适合用于自定义AI应用的开发，复制下面的安装命令直接安装到项目下面即可。

安装

使用npm或pip安装MCP客户端：

  • NPM

    npm install @smcphub/client

  • Python

    pip install smcphub-client

使用（NodeJS示例）

  • connect(): 连接MCP服务端并获取所有工具列表

    • 参数：无

    示例代码：

    import SmcphubClient from '@smcphub/client';

const smcphubClient = new SmcphubClient({
    api_key: 'your-api-key',
});
const tools = await smcphubClient.connect();

console.log(tools);
  • callTool(name, parameters): 调用指定工具获取数据

    • 参数：

    • name: 工具名称
    • parameters: 工具参数

    示例代码：

    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服务

  1. 点击页面头部右上角的“快速发布MCP服务”按钮
  2. 或者进入用户中心的“MCP服务管理”，再进入“发布MCP服务”页面

如何配置MCP服务

进入用户中心的“MCP服务管理”，打开“我发布的”页面，然后再点击操作栏的配置图标。

如何部署MCP服务

进入用户中心的“MCP服务管理”，打开“我发布的”页面，然后再点击操作栏的云部署图标。