Add MCP server

.github/workflows/ci.yml

@@ -52,6 +52,7 @@ jobs:
           - hd-audio
           - cli
           - pygments
+          - mcp
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v6

docs/mcp.md

@@ -0,0 +1,38 @@
+# MCP Server
+
+The `voip` package ships a ready-made [Model Context Protocol (MCP)][mcp] server
+that exposes tools to make phone calls on your behalf to any MCP client.
+
+## Claude Code setup
+
+Add the server to your MCP config (see [Claude Code MCP docs][cc-mcp]):
+
+```json
+{
+  "mcpServers": {
+    "VoIP": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": [
+        "-y",
+        "voip[mcp]",
+        "mcp"
+      ],
+      "env": {
+        "SIP_AOR": "sip:****:****@example.com:5060?transport=tcp"
+      }
+    }
+  }
+}
+```
+
+Set `SIP_AOR` to your SIP address-of-record.
+
+## Tools
+
+::: voip.mcp.say
+
+::: voip.mcp.call
+
+[cc-mcp]: https://docs.anthropic.com/en/docs/claude-code/mcp
+[mcp]: https://modelcontextprotocol.io/

mkdocs.yml

@@ -6,6 +6,7 @@ watch:
 nav:
   - Usage:
       - Quickstart: index.md
+      - MCP Server: mcp.md
       - Cookbook: cookbook.md
       - Sessions: sessions.md
       - SIP: sip.md

pyproject.toml

@@ -41,6 +41,7 @@ dependencies = ["cryptography"]
 audio = ["numpy"]
 hd-audio = ["numpy", "av"]
 ai = ["faster-whisper", "numpy", "av", "ollama", "pocket-tts"]
+mcp = ["fastmcp>=3.2.4", "faster-whisper", "numpy", "av", "ollama", "pocket-tts"]
 cli = ["click", "pygments", "faster-whisper", "numpy", "ollama", "pocket-tts"]
 pygments = ["Pygments"]