npm @metricspot/mcp-serverstreamable-httpupdated 3mo ago
Model Context Protocol server for MetricSpot. Exposes 6 SEO + AI-readability audit tools to AI agents (Claude, ChatGPT, Gemini, Perplexity, Cursor, Zed, OpenClaw, custom bots).
seo mcp 能做什么?
@metricspot/mcp-server
Model Context Protocol server for MetricSpot. Exposes 6 SEO + AI-readability audit tools to AI agents (Claude, ChatGPT, Gemini, Perplexity, Cursor, Zed, OpenClaw, custom bots).
- Hosted Streamable HTTP endpoint:
https://mcp.metricspot.com/mcp - Local stdio binary:
npx @metricspot/mcp-server - Agent guide: https://metricspot.com/AGENTS.md
Tools
| Tool | Auth | Description |
|---|---|---|
run_audit_anonymous |
none | One-shot audit, 1/IP/24h, no Core Web Vitals |
run_audit |
Bearer key | Full audit with PSI, returns audit_id |
get_audit |
Bearer key | Fetch audit + findings by id |
list_audits |
Bearer key | List the user's recent audits (max 100) |
get_audit_pdf |
Bearer key | Signed URL for the branded PDF report |
get_organic_traffic |
Bearer key | 28-day GA4 + GSC snapshot (if Google linked) |
Local install (stdio)
Claude Code (~/.claude/mcp.json):
{
"mcpServers": {
"metricspot": {
"command": "npx",
"args": ["-y", "@metricspot/mcp-server"],
"env": {
"MCP_API_KEY": "ms_live_xxx"
}
}
}
}
Cursor (~/.cursor/mcp.json) and Zed use the same shape.
Omit MCP_API_KEY to only use run_audit_anonymous.
Hosted (Streamable HTTP)
POST https://mcp.metricspot.com/mcp
Authorization: Bearer ms_live_xxx
Content-Type: application/json
{"jsonrpc":"2.0","id":1,"method":"tools/list"}
Env vars
| Var | Default | Purpose |
|---|---|---|
PORT |
3000 |
HTTP listen port |
APP_API_BASE_URL |
https://app.metricspot.com |
MetricSpot app API base (the dev/dev:stdio scripts override it to http://localhost:3000) |
APP_PUBLIC_BASE_URL |
falls back to APP_API_BASE_URL |
Used to build report_url |
MCP_INTERNAL_TOKEN |
— | Service-to-service secret forwarded as X-MCP-Internal-Token |
MCP_API_KEY |
— | (stdio only) User API key, sent as Authorization: Bearer to the HTTP layer |
Develop
bun install
bun run typecheck
bun test
bun run dev # Streamable HTTP on :3000
bun run dev:stdio # stdio loop (send JSON-RPC on stdin)
Deploy
Multi-stage Dockerfile produces a Bun runtime image. Independent Dokku app on the same Hetzner droplet as app/ and web/.
License
MIT
安装
把 seo mcp 添加到你的客户端。选择你正在使用的那个。
{
"servers": {
"mcp-server": {
"type": "http",
"url": "https://mcp.metricspot.com/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
claude mcp add mcp-server -- npx -y @metricspot/mcp-servercodex mcp add mcp-server -- npx -y @metricspot/mcp-serveramp mcp add mcp-server -- npx -y @metricspot/mcp-server{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@metricspot/mcp-server"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@metricspot/mcp-server"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@metricspot/mcp-server"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@metricspot/mcp-server"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@metricspot/mcp-server"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"mcp-server": {
"type": "local",
"command": "npx",
"args": [
"-y",
"@metricspot/mcp-server"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"mcp-server": {
"command": {
"path": "npx",
"args": [
"-y",
"@metricspot/mcp-server"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y @metricspot/mcp-serverRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
6 个工具
seo mcp 向已连接的智能体提供 6 个工具。
- run_audit_anonymous
- none
- run_audit
- Bearer key
- get_audit
- Bearer key
- list_audits
- Bearer key
- get_audit_pdf
- Bearer key
- get_organic_traffic
- Bearer key
评分
65 / 100
良好
- 文档22/25
- 维护13/25
- 可信度9/20
- 能力6/15
- 安装体验15/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 102 days ago
- Has a release history
- Repository is not archived
- No licence detected
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 6 tool(s) documented
- Provides prompt templates
- Provides resources
- 18 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
版本历史
| 版本 | 发布于 |
|---|---|
| 0.1.1最新 | 2026年5月14日 |