A
licenseB
qualityC
maintenanceEnables AI agents to interact with Microsoft SQL Server databases via MCP, supporting table listing, schema retrieval, and CRUD operations.
Last updated
3
1
MIT
ragic-mcp
by EthanH9977
This MCP server lets you interact with Ragic (a cloud database/form platform) through an AI assistant or CLI, covering 11 tools for sheet exploration, full CRUD operations, search, approval workflows, and record locking.
Discover sheets (
ragic_list_sheets): List all sheets accessible by the configured API key, grouped by tab — useful for finding a sheet by name without knowing its URL.List records (
ragic_list_records): Retrieve records from a sheet with support for filtering, sorting, pagination, subtables, approval status, and history.Get a single record (
ragic_get_record): Fetch one specific record by its ID, including optional subtable data, approval info, and edit history.Full-text search (
ragic_search): Search all text across a sheet using a keyword query.Create records (
ragic_create_record): Add new records to a sheet, including subtable rows, with control over formulas, workflows, notifications, and validation.Update records (
ragic_update_record): Partially update specific fields of an existing record, with lock-checking enabled by default.Delete records (
ragic_delete_record): Remove a single record from a sheet.Approve or reject records (
ragic_approve): Trigger the Ragic approval workflow to approve or reject a record, with an optional comment.Lock records (
ragic_lock): Lock a record to prevent further edits.Unlock records (
ragic_unlock): Remove the lock from a previously locked record.Filter/parameter help (
ragic_filter_help): Retrieve a cheatsheet covering filter syntax, system field IDs, subtable write formats, and rate limit information.
All operations respect Ragic's API key permissions — read-only keys block write tools, while write-capable keys enable full functionality.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ragic-mcpList all sheets I can read"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ragic-mcp
讓 AI（Claude Desktop、Claude Code、其他 MCP client）直接操作 Ragic 的 MCP server。11 個 tool 涵蓋表單探索、讀取、寫入、簽核、上鎖。
權限完全由 Ragic 那邊的 API key 控制——key 是 read-only，寫入類 tool 就會收到 Ragic 的權限錯誤；key 有寫入權限就全用得到。
AI 怎麼用這個 server 看 AGENTS.md。這份檔案只講「給人類的安裝與設定」。
一、需要的東西
Ragic 帳號與有效 API key（Ragic 後台 → 個人設定 → 帳號設定 → API key）
Python 3.10+
uv（推薦）：
brew install uv或pip install uv
Related MCP server: Airtable MCP Server
二、安裝
懶人路線：把這個 repo 網址
https://github.com/EthanH9977/ragic-mcp貼給你的 AI，說「幫我裝這個 MCP」。AI 會照 AGENTS.md §0 的 6 步流程自動跑完安裝＋設定＋註冊到 MCP client。下面是手動流程：
uv tool install git+https://github.com/EthanH9977/ragic-mcp.git裝完 ragic-mcp 命令會自動在 PATH 裡，任何 terminal 直接跑。確認：
which ragic-mcp
# 應該回：/Users/<你>/.local/bin/ragic-mcp沒裝 uv？
brew install uv（macOS）或看 uv 官網。
三、設定 credentials（一次就好）
在 terminal 跑：
ragic-mcp setup這會：
在
~/.config/ragic-mcp/config.json建立一份模板（檔案權限自動 0600，只有你本人能讀）用你系統預設的文字編輯器（macOS = TextEdit、Windows = Notepad、Linux =
$EDITOR）打開你直接在編輯器裡填三個值，存檔關閉
模板長這樣，把右邊三個值換成你的：
{
"RAGIC_SERVER": "ap5.ragic.com",
"RAGIC_ACCOUNT": "your_account_here",
"RAGIC_API_KEY": "paste_your_api_key_here"
}欄位 | 取自你 Ragic 表單網址 |
RAGIC_SERVER |
|
RAGIC_ACCOUNT | 網域後第一段 |
RAGIC_API_KEY | Ragic 後台 → 個人設定 → 帳號設定 → API key |
其他相關指令
ragic-mcp show # 顯示目前設定（API key 自動 mask 成首尾 4 碼）
ragic-mcp clear # 刪除本機 config
ragic-mcp serve # 啟動 MCP server（預設行為，給 client 呼叫）如果你不想存到檔案，也可以用環境變數覆蓋（env var 優先序高於 config 檔）：
RAGIC_SERVER=... RAGIC_ACCOUNT=... RAGIC_API_KEY=... ragic-mcp四、接到 MCP client
Claude Desktop
打開 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows），加入：
{
"mcpServers": {
"ragic": {
"command": "ragic-mcp"
}
}
}注意：
command要寫成ragic-mcp可被 PATH 找到。如果你是裝在 venv，要寫絕對路徑，例如：/path/to/your/venv/bin/ragic-mcp
存檔後重啟 Claude Desktop。
Claude Code
claude mcp add --scope user ragic ragic-mcp（如果 ragic-mcp 不在 PATH，改成絕對路徑。）
其他 MCP client
任何支援 stdio transport 的 client 都行。指令一律是：
ragic-mcp五、驗證
在 MCP client 對話視窗問：
呼叫 ragic_filter_help 看 cheatsheet
收到一份 Ragic API filter cheatsheet 就表示通了。
接著測讀取——直接讓 AI 自己探索你的表：
用 ragic_list_sheets 列出我所有可以讀的表
AI 拿到表清單後就能直接幫你查特定表，不用再貼網址。
六、提供的 tool（11 個）
Tool | 動作 | API key 需要的權限 |
| 列出帳號下所有可讀的表（含中文名、path、sheet_index） | read |
| 列表＋過濾＋排序＋分頁 | read |
| 讀單筆 | read |
| 全文檢索 | read |
| 新增（含子表） | write |
| 局部更新欄位 | write |
| 刪除單筆 | write |
| 簽核（approve／reject） | approval |
| 上鎖 | write |
| 解鎖 | write |
| 取 filter／參數速查表 | — |
每個 tool 的詳細參數、where 過濾語法、子表格寫入格式寫在 AGENTS.md。
七、安全設計
防線 | 怎麼擋 |
API key 不入 git |
|
API key 不外流 | 設定檔權限 |
API key 不入 shell history |
|
主機白名單 | client 拒絕非 |
不跟 redirect |
|
寫入錯誤偵測 | Ragic 寫入失敗會回 HTTP 200 + |
依然要遵守的最佳實務：
API key 給最小權限（read-only 就好的場景不要發 write key）
不要把
~/.config/ragic-mcp/config.json拷貝到雲端硬碟或截圖外傳懷疑外流時：Ragic 後台 revoke → 重新跑
ragic-mcp setup
八、Ragic 限速
同時待處理佇列 50 個
持續超過 5 req/sec 會被人工審查
九、回報問題
十一、CLI 直接操作資料
除了 MCP server 模式，ragic-mcp 也提供 11 個子指令讓你在 terminal 直接讀寫 Ragic，無需 MCP client。
安裝
uv tool install --editable /path/to/ragic-mcp # 本機開發版
# 或從 GitHub 安裝正式版：
uv tool install git+https://github.com/EthanH9977/ragic-mcp.git設定 credentials 同 MCP 模式（ragic-mcp setup），CLI 讀同一份 ~/.config/ragic-mcp/config.json。
全域選項：--config <路徑> 可覆寫設定檔路徑。
子指令速查
子指令 | 說明 | 防呆 |
| 列出所有可讀的表 | — |
| 列表（支援 | — |
| 讀單筆 | — |
| 全文搜尋 | — |
| 顯示 filter／參數速查表 | — |
| 新增記錄 | — |
| 更新欄位 | — |
| 刪除記錄 | 需 |
| 簽核（ | 需 |
| 上鎖 | — |
| 解鎖 | — |
結果輸出為 JSON（stdout）；錯誤輸出到 stderr 且 exit code 非 0；delete-record/approve 無 --yes 時 exit 2 且不呼叫 API。
範例：
# 列出所有表
ragic-mcp list-sheets
# 列出前 3 筆（FNAME 欄位名稱）
ragic-mcp list-records sales 1 --limit 3
# 讀單筆
ragic-mcp get-record sales 1 12345
# 全文搜尋
ragic-mcp search sales 1 "Acme Corp"
# 查 filter 語法
ragic-mcp filter-help
# 刪除（需 --yes）
ragic-mcp delete-record sales 1 12345 --yes與 MCP 併存
CLI 與 MCP server 完全複用同一份 client 與 config，無需額外設定。若你的 AI assistant 已透過 MCP 連接 Ragic，CLI 仍可在 terminal 獨立使用，兩者不衝突。
十二、授權
MIT
Maintenance
–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityDmaintenanceEnables AI-powered interaction with Airtable bases, supporting CRUD operations, schema management, webhooks, and natural language queries through the MCP protocol.Last updated97MIT
- Flicense-qualityCmaintenanceEnables AI agents to read and modify Mendix application models through MCP tools for creating modules, entities, pages, microflows, deploying, and querying runtime data.Last updated1
- Flicense-qualityCmaintenanceEnables generic CRUD operations on ERPNext/Frappe DocTypes via MCP tools, allowing users to interact with ERPNext data like documents, reports, and schema through natural language commands.Last updated
Related MCP Connectors
Free public MCP for AI agents — 193 tools, 44 workflows. No API key.
Self-hosted MCP gateway: turn any API, database or MCP server into AI connectors — no code.
Manage SRG+ hubs, channels, content, assets, users, and workspaces from any MCP-aware AI agent.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/EthanH9977/ragic-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server