Sipflow

Sipflow MCP

为 AI Agent 提供 SIP/VoIP/电信领域知识。涵盖约 40 种技术栈的供应商文档、 60 多篇 RFC、STIR/SHAKEN、跟踪和配置分析——每个答案都引用逐字 保留的 source_url。

Sipflow 是一个托管的、只读的 Model Context Protocol 服务。它为你的编辑器或 Agent 提供约 20 个工具，让 SIP/VoIP 答案基于精选语料， 而不是依赖训练数据回忆。

• 在线端点： https://mcp.sipflow.dev/mcp（Streamable HTTP）
• Web 应用： https://www.sipflow.dev
• 安装页面（一键安装 + 所有客户端）： https://www.sipflow.dev/tools/mcp

安装

Cursor（一键安装）

在 Cursor 中安装 Sipflow

也可以从 Cursor Marketplace 安装。本仓库 也以 Cursor 插件形式发布，并内置了 Skill 和 Rule（见下文的 本仓库包含什么）。

Cursor（手动安装）- ~/.cursor/mcp.json

{
  "mcpServers": {
    "sipflow": { "url": "https://mcp.sipflow.dev/mcp" }
  }
}

VS Code - .vscode/mcp.json 或用户 settings.json

{
  "servers": {
    "sipflow": {
      "type": "http",
      "url": "https://mcp.sipflow.dev/mcp"
    }
  }
}

需要 VS Code 1.99+ 和 GitHub Copilot 扩展。

Claude Desktop - claude_desktop_config.json

Claude Desktop 仅支持 stdio，因此请使用 mcp-remote 垫片：

{
  "mcpServers": {
    "sipflow": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.sipflow.dev/mcp"]
    }
  }
}

Claude Code（CLI）

claude mcp add --transport http sipflow https://mcp.sipflow.dev/mcp

Codex CLI - ~/.codex/config.toml

[mcp_servers.sipflow]
url = "https://mcp.sipflow.dev/mcp"

Cline - Settings -> MCP Servers -> Edit JSON

{
  "mcpServers": {
    "sipflow": { "url": "https://mcp.sipflow.dev/mcp" }
  }
}

Continue - ~/.continue/config.yaml

mcpServers:
  - name: sipflow
    transport:
      type: streamable-http
      url: https://mcp.sipflow.dev/mcp

Windsurf - ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "sipflow": {
      "serverUrl": "https://mcp.sipflow.dev/mcp"
    }
  }
}

Goose - ~/.config/goose/config.yaml

extensions:
  sipflow:
    type: http
    uri: https://mcp.sipflow.dev/mcp
    enabled: true

通用 / curl 冒烟测试

curl -sS -X POST https://mcp.sipflow.dev/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

本仓库包含什么

文件 / 文件夹	市场	用途
server.json	Official MCP Registry	规范的服务描述文件。PulseMCP 会从此处自动导入。
smithery.yaml	Smithery	远程 HTTP 列表项。
.cursor-plugin/plugin.json	Cursor Marketplace	插件清单。
mcp.json	Cursor 插件自动发现	将插件指向远程端点。
skills/sip-debugger/	Cursor 插件	以 /sip-debugger 形式提供的“何时使用 Sipflow”操作指南。
rules/sip-grounding.mdc	Cursor 插件	编辑 .pcap、kamailio/opensips/freeswitch/asterisk 配置、拨号方案、.sdp 时自动附加。
assets/logo.svg	全部	Logo。

非 Cursor 市场会静默忽略 Cursor 专用文件（.cursor-plugin/、mcp.json、skills/、 rules/）——它们只解析各自的清单。

工具目录

所有工具均为只读。唯一的出站 IO 是 dns_diagnose_sip_target （DNS + TLS 握手）和 validate_stir_shaken_identity（获取证书）。

发现 / 知识依据 - search_sip_docs、lookup_response_code、 lookup_sip_header

检测 - detect_sip_stack、detect_sip_vendor_from_config

跟踪 - minimize_sip_trace、render_sip_ladder、 sip_ladder_example、lint_sip_request、parse_sip_message、 diff_sip_messages

配置审查 - review_sip_config、webrtc_sip_checklist

SDP - parse_sdp、compare_sdp_offer_answer

STIR/SHAKEN - validate_stir_shaken_identity、 stir_attestation_explainer

电信 - validate_e164_number、troubleshoot_response_code

网络 - dns_diagnose_sip_target（速率受限）

共享内容获取 - fetch_sipflow_share，用于获取 sipflow.dev/share/<token> URL 的内容

资源 - sipflow://docs/{vendor}/{id}，用于获取单个语料片段

语料覆盖范围

• 约 40 种供应商技术栈：Kamailio、OpenSIPS、FreeSWITCH、Asterisk（PJSIP + chan_sip）、 SIP.js、JsSIP、FreePBX、3CX、OpenSER、Twilio、Cisco，……
• 60 多篇 RFC：SIP、SDP、RTP、WebRTC 核心规范
• STIR/SHAKEN：RFC 8224/8225/8226/8588/9027/9795
• 品牌来电：ATIS-1000074、ATIS-1000094、ATIS-1000084、CTIA BCID

本地开发（Cursor 插件）

通过将此仓库符号链接到 Cursor 的本地插件文件夹，在本地测试插件：

ln -s "$PWD" ~/.cursor/plugins/local/sipflow

在 Cursor 中运行 Developer: Reload Window。你应该会看到：

• Settings -> Features -> Model Context Protocol 中的 sipflow 服务
• Settings -> Rules（Agent 决定）下的 sip-debugger 技能
• Settings -> Rules 下的 sip-grounding 规则

提交更新

MCP 服务发生变更时，请在以下三个位置更新 version，以保持注册表同步：

• server.json -> 官方 MCP 注册表
• .cursor-plugin/plugin.json -> Cursor Marketplace
• 托管服务的 serverInfo.version

然后重新运行 mcp-publisher publish，以发布到官方注册表。Cursor、Smithery 和 Glama 会自动跟踪默认分支。

许可证

MIT - 详见 LICENSE。