MCP 服务创建指南

MCP 服务创建指南
1. 基础信息
名称 (必填)

• 用途：MCP 服务器的唯一标识名称，用于识别和区分不同服务。
• 填写规则
  
  • 中文或英文字符
    
• 示例： 纳米AI Browser
  

描述

• 用途： 对服务功能、用途的简要说明，帮助用户快速理解服务能力。
• 填写规则：
  
  • 中文或英文字符
    
• 示例： 纳米AI浏览器自动化，允许LLMs与网页进行交互，执行任务如导航、截图、点击、填充表单、选择元素及执行JavaScript代码，实现高度自动化的网页操作。
  

2. 服务类型选择
标准输入/输出 (stdio)

• 适用场景：需要在本地运行程序或脚本的本地工具 (如执行 , python, exe 等类型的本地文件)
• 特点： 本地程序，无网络依赖
  

服务器发送事件 (sse)

• 适用场景: 远程部署的服务器，需提供服务的URL来供客户端建立连接
• 特定： 服务器流式传输消息
  

可流式传输的HTTP (streamableHttp)

• 适用场景: 远程部署的服务器，需提供服务的URL来供客户端建立连接
• 特点： 支持普通 HTTP 响应和流式传输消息，内置会话ID机制支持断线重连和状态恢复
  

3. stdio 类型服务配置
命令 (必填)

• 含义： 启动 MCP 服务器的执行命令，支持 npx/uvx 或合法的自定义指令
• 示例：
  
  • npx ：支持执行 npm 包
  • uvx：支持执行 python 包
  • 自定义指令：
    
    • cmd 适用于 windows 系统
    • bash 适用于 unix 系统
    • 其他当前环境可执行的全局指令
      

参数

• 含义： 具体的 MCP 服务器的包名，以及传递给服务器脚本的命令行参数（根据具体服务器的需要选择配置），用于启动和配置特定的服务
• 示例： 填写格式为每个参数占一行
  
  • 使用 npx:
    
    • -y
    • server-namiaibrowser-use
    • // 其他命令行参数，根据具体服务器的需要选择配置
      
  • 使用 uvx:
    
    • nba-mcp-server
    • // 其他命令行参数，根据具体服务器的需要选择配置
      
  • 使用自定义指令：注意需要填写具体可执行文件的绝对路径
    
    • bash
      
      • -c
      • /app/path
      • /dist/main.py
        
    • cmd
      
      • /c
      • D:\app\path
      • D:\dist\index.js
        

环境变量

• 含义： 用于配置服务运行时的敏感信息或全局参数（非必填，推荐用于敏感数据，如 TOKEN 等）
• 示例： 填写格式为每行 key=value
  
  • API_KEY=your_key
  • ACCESS_TOKEN=your_token
    

4. SSE / StreamableHttp 类型服务配置
URL (必填)

• 含义： 服务器提供的 API 端点，客户端通过此地址连接到服务器
• 示例： http://localhost:3000/sse , http://localhost:3000/mcp
  

请求头

• 含义： 向服务器发送请求时附加的 HTTP 头信息，用于认证、数据格式定义等 (需根据服务要求配置)
• 示例： 填写格式为每行 key=value
  
  • // 指定请求体格式为 JSON
  • Content-Type=application/json
  • // 填写认证令牌（如 JWT），确保服务对客户端的身份验证
  • Authorization=Bearer token
    

添加MCP，提示添加失败是为什么啊？