开发文档

快速开始

欢迎使用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服务管理”,打开“我发布的”页面,然后再点击操作栏的云部署图标。