Schematic MCP

🚀 原理圖MCP服務器

這是一個 MCP 服務器，它將AI助手連接到 原理圖 —— 一個用於管理計費、套餐、功能和權限的平臺。

使用此服務器，讓Claude、Cursor或任何兼容MCP的客戶端通過自然語言查找公司、管理套餐權限、設置覆蓋規則、創建功能等。

🚀 快速開始

前提條件

1. 獲取原理圖API密鑰：註冊 原理圖賬戶，並從 原理圖儀表盤 獲取API密鑰。

📦 安裝指南

選項1：使用Claude CLI（推薦）

1. 從npm安裝軟件包：

npm i @schematichq/schematic-mcp

2. 將MCP服務器添加到Claude：

claude mcp add --transport stdio --scope project schematic --env SCHEMATIC_API_KEY=your-api-key-here -- npx @schematichq/schematic-mcp

將 your-api-key-here 替換為你實際的原理圖API密鑰。

選項2：手動配置

Claude桌面版 / Claude代碼版

添加到你的Claude配置文件（在macOS上為 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "schematic": {
      "command": "npx",
      "args": ["-y", "@schematichq/schematic-mcp"],
      "env": {
        "SCHEMATIC_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

添加到你的Cursor MCP配置文件（設置 > MCP服務器，或直接編輯文件）：

• macOS：~/.cursor/mcp.json
• Linux：~/.cursor/mcp.json
• Windows：%USERPROFILE%\.cursor\mcp.json

{
  "mcpServers": {
    "schematic": {
      "command": "npx",
      "args": ["-y", "@schematichq/schematic-mcp"],
      "env": {
        "SCHEMATIC_API_KEY": "your-api-key-here"
      }
    }
  }
}

添加配置後，重啟Cursor以使服務器生效。

📚 詳細文檔

配置

服務器需要一個原理圖API密鑰。它按以下順序檢查兩個來源：

1. 環境變量（推薦）：SCHEMATIC_API_KEY
2. 配置文件（備用）：~/.schematic-mcp/config.json

{
  "apiKey": "your-api-key-here"
}

你可以在 原理圖儀表盤 中找到你的API密鑰。

💻 使用示例

工具

公司查找

公司覆蓋規則

套餐管理

功能管理

示例提示

配置完成後，你可以嘗試向AI助手提問：

• "Acme Corp使用的是什麼套餐？"
• "列出我所有的套餐及其功能"
• "創建一個名為 '高級分析' 的布爾型功能"
• "為Acme Corp設置無限的API調用覆蓋規則"
• "有多少家公司使用專業版套餐？"
• "查找與Stripe客戶cus_abc123關聯的原理圖公司"

開發

# 安裝依賴
yarn install

# 構建
yarn build

# 在開發模式下運行（更改時自動重新編譯）
yarn dev

# 運行測試
yarn test

📄 許可證

本項目採用MIT許可證。