Merge pull request #4 from agents-oss/ci/deploy_mcp_server

ci: publish mcp

Author: skokaina

.github/workflows/publish.yml

@@ -70,6 +70,11 @@ jobs:
           cd packages/sdk
           npm publish --access public --provenance
 
+      - name: Publish @agentspec/mcp
+        run: |
+          cd packages/mcp-server
+          npm publish --access public --provenance
+
       - name: Resolve workspace deps for adapter-claude
         run: |
           SDK_VER=$(node -p "require('./packages/sdk/package.json').version")
@@ -110,5 +115,6 @@ jobs:
           echo "**Version:** ${VERSION}" >> $GITHUB_STEP_SUMMARY
           echo "" >> $GITHUB_STEP_SUMMARY
           echo "- \`@agentspec/sdk@${VERSION}\`" >> $GITHUB_STEP_SUMMARY
+          echo "- \`@agentspec/mcp@${VERSION}\`" >> $GITHUB_STEP_SUMMARY
           echo "- \`@agentspec/adapter-claude@${VERSION}\`" >> $GITHUB_STEP_SUMMARY
           echo "- \`@agentspec/cli@${VERSION}\`" >> $GITHUB_STEP_SUMMARY

docs/concepts/operating-modes.md

@@ -68,6 +68,26 @@ agent in the AgentSpec Agents view, the extension port-forwards automatically.
 
 ### MCP configuration
 
+Install the MCP server in your AI editor:
+
+**Claude Code / Cursor / Windsurf** — add to your MCP config:
+```json
+{
+  "mcpServers": {
+    "agentspec": {
+      "command": "npx",
+      "args": ["-y", "@agentspec/mcp"]
+    }
+  }
+}
+```
+
+**Claude Code** (`.claude/settings.json` or via `claude mcp add`):
+```bash
+claude mcp add agentspec -- npx -y @agentspec/mcp
+```
+
+Tool arguments for sidecar mode:
 ```json
 // agentspec_health
 { "sidecarUrl": "http://localhost:4001" }
@@ -138,6 +158,9 @@ port-forward.
 
 ### MCP configuration
 
+Same install as sidecar mode — `@agentspec/mcp` supports both modes via tool arguments.
+
+Tool arguments for operator mode:
 ```json
 // agentspec_health
 {

docs/quick-start.md

@@ -167,6 +167,20 @@ kubectl apply -f ./generated/k8s/deployment.yaml
 kubectl apply -f ./generated/k8s/service.yaml
 ```
 
+## Use AgentSpec from your AI editor (MCP)
+
+Install `@agentspec/mcp` to use AgentSpec tools directly inside Claude Code, Cursor, or Windsurf:
+
+```bash
+# Claude Code
+claude mcp add agentspec -- npx -y @agentspec/mcp
+
+# Cursor / Windsurf / any MCP-compatible editor — add to mcpServers config:
+# { "mcpServers": { "agentspec": { "command": "npx", "args": ["-y", "@agentspec/mcp"] } } }
+```
+
+See [Operating Modes](./concepts/operating-modes) for sidecar vs operator configuration.
+
 ## What to do next
 
 | I want to...                          | Go to                                                                                        |

packages/mcp-server/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "@agentspec/mcp-server",
+  "name": "@agentspec/mcp",
   "version": "0.1.0",
   "description": "AgentSpec MCP server — exposes validate, health, audit, scan, generate, gap, diff as MCP tools",
   "author": "Sallah Kokaina <sallah.kokaina@gmail.com>",

packages/mcp-server/src/index.ts

@@ -4,7 +4,7 @@
  * POST /mcp  →  JSON-RPC 2.0 for tools/list + tools/call
  *
  * Add to Claude Code / Cursor / Windsurf:
- *   { "mcpServers": { "agentspec": { "command": "npx", "args": ["-y", "@agentspec/mcp-server"] } } }
+ *   { "mcpServers": { "agentspec": { "command": "npx", "args": ["-y", "@agentspec/mcp"] } } }
  */
 
 import http from 'http'