MisarDev MCP Server

MisarDev MCP Server

通过任意 AI 助手创建、构建和部署项目，使用检查点回滚，连接自定义域名，以及搜索代码和网络。

54 个工具 · 5 个提示词 · 3 个资源 · 4 个 Agent 技能

支持 Claude（桌面版、Code 和网页版）、Cursor、VS Code、Windsurf、Cline、 Zed、Gemini CLI、ChatGPT 及其他所有兼容 MCP 的客户端，可通过 stdio 或 Streamable HTTP 连接。

---

安装

Smithery（推荐）

npx -y @smithery/cli install misar/misardev-mcp --client claude

Claude Code

claude mcp add misardev -- npx -y @misardev/mcp@latest

手动安装（任意客户端）

{
  "mcpServers": {
    "misardev": {
      "command": "npx",
      "args": ["-y", "@misardev/mcp@latest"],
      "env": { "MISARDEV_API_KEY": "mdk_your_key_here" }
    }
  }
}

各客户端的现成配置位于 connectors/。

远程连接（无需安装）

{
  "mcpServers": {
    "misardev": {
      "type": "streamable-http",
      "url": "https://api.misar.io/dev/mcp",
      "headers": { "Authorization": "Bearer mdk_your_key_here" }
    }
  }
}

---

身份验证

在 https://misar.dev/settings/api-keys（Settings → API keys）创建 API 密钥——密钥以 mdk_ 开头——然后通过以下三种方式之一提供给服务：MISARDEV_API_KEY 环境变量、MCP 客户端的 env 块，或 ~/.misardev/config.json 中的 { "api_key": "mdk_…" }。

可自托管实例：设置 MISARDEV_BASE_URL。

---

工具

工具	描述
list_projects	按时间从新到旧列出你拥有或有权访问的项目，支持游标分页。
get_project	按 ID 获取一个项目的信息：名称、描述、设置、可见性、版本和部署字段。
create_project	创建一个新的空项目（可选用文件映射初始化）。
update_project	更新项目的名称、描述、文件、设置或可见性。
delete_project	将项目移至回收站。
restore_project	从回收站恢复项目。
archive_project	归档（archived=true）或取消归档（archived=false）项目。
duplicate_project	将项目（文件和设置）复制到你拥有的新项目中，新项目沿用原项目的名称。
get_project_files	获取项目的文件树及文件内容。
write_project_files	在项目中创建、更新或删除文件（每次调用 1–100 个，每个最大 1 MB；路径为相对路径，不能包含 ..）。
import_artifact	将已发布的 Misar artifact 页面导入项目，保存为 imported/ARTIFACT_ID.html。
get_project_knowledge	读取项目的知识库内容——AI 构建器每次更改时都会读取的常驻备注（产品背景、约定和约束）。。
update_project_knowledge	替换项目的知识库内容（最多 20,000 个字符）——AI 构建器每次更改时都会读取的常驻备注。
get_project_backend	显示全栈项目的数据库后端：是否已配置、架构名称、表数量和连接状态。。
provision_project_backend	为全栈项目配置数据库后端：创建独立的架构，并通过行级安全策略加以保护。
list_templates	列出新项目可使用的起始模板及其 ID、名称和类别。
get_template	按 ID 获取一个模板的信息：描述、技术栈和将要创建的文件。。
use_template	使用模板创建新项目。
deploy_project	将项目发布到 MisarDev 运行时，使其可通过公共互联网访问（可选使用指定子域名）。
get_deployment_status	获取项目当前的部署状态：是否已上线、URL、子域名和自定义域名状态。
unpublish_project	使已发布的网站下线。
check_subdomain	检查此项目能否使用指定的子域名标签；若不可用，则获取建议。
update_project_subdomain	将项目迁移至新的 .misar.app 地址（请先使用 check_subdomain 检查）。
list_builds	按时间从新到旧列出你在所有项目中的近期 AI 构建任务，包括状态、模型及所属项目。。
get_build_status	获取项目当前是否正在运行构建，以及最新的构建状态。
cancel_build	取消项目当前正在运行的构建。
list_checkpoints	列出项目已保存的检查点（最多 100 个，按时间从新到旧），包括标签、已更改的路径和时间戳。
restore_checkpoint	将项目文件恢复到某个检查点。
rename_checkpoint	为检查点添加便于理解的标签（1–80 个字符），方便日后查找。。
delete_checkpoint	从项目版本历史中删除一个检查点。
get_custom_domain	获取项目的自定义域名、其状态、用户必须设置的 DNS 记录，以及 DNS 是否已解析至平台（解析成功后将自动签发 TLS）。。
set_custom_domain	将用户拥有的域名关联到已发布的项目，并配置路由和 TLS。
remove_custom_domain	解除项目自定义域名的关联并移除其路由。
lookup_domain	查询域名的公开注册信息（RDAP）：是否已注册、注册商和重要日期。
search_workspace	按名称和描述搜索你的项目及公共目录（模板、技能和已发布的图库）。
web_search	使用实时网络搜索回答问题并提供引用（MisarDev 的基于检索的搜索）。
create_chat_completion	在 MisarDev 兼容 OpenAI 的模型 API 上运行一次非流式聊天补全。
index_project_code	为项目文件建立索引，以便进行语义代码搜索（RAG）。
search_project_code	在已建立索引的项目代码中进行语义搜索。
get_code_index_stats	获取项目的嵌入统计信息——已建立索引的文件和文本块数量，以及索引时间。。
clear_code_index	删除项目的所有嵌入。
upgrade	显示当前 MisarDev 套餐、本周期各项配额（构建、编辑、项目）的剩余数量，以及比较和升级套餐的链接。
get_usage	获取账户的详细用量。
get_subscription	获取账户的订阅信息：套餐、状态、当前周期结束时间，以及是否会在周期结束时取消。。
list_plans	列出 MisarDev 的套餐、价格、限制和功能——升级后可解锁的内容。。
list_notifications	按时间从新到旧列出你的通知（构建完成、部署失败、邀请……），并显示未读数量。
mark_notifications_read	将所有通知标记为已读，清除未读徽标。
list_api_keys	列出你的 API 密钥，包括名称、前缀、创建和到期日期以及 IP 允许列表。
create_api_key	创建新的 API 密钥。
revoke_api_key	按 ID 撤销 API 密钥。
mark_notification_read	将一条通知标记为已读（要全部标记为已读，请使用 mark_notifications_read）。。
list_audit_log	按时间从新到旧列出你自己的审计记录——你作为操作者触发的 API 密钥、部署和账单事件。
list_connectors	列出 MisarDev 上可用的连接器，以及每个连接器是否已为你启用，并显示其类别、状态和控制面板路径。。
toggle_connector	按 slug（来自 list_connectors）启用或禁用连接器。

提示词

客户端以斜杠命令形式公开的可复用工作流。

提示词	描述
ship_a_project	将项目从模板发布到线上，并验证部署。
undo_a_bad_change	将项目回滚到较早的检查点；如果项目已上线，则重新部署。
deployment_health	检查近期构建和部署，并指出需要关注的事项。
search_the_codebase	根据项目的索引代码回答问题。
usage_and_keys_audit	检查套餐用量和 API 密钥，发现异常情况。

资源

Agent 无需调用工具即可附加的只读上下文。

URI	描述
misardev://projects	当前活跃的项目，按创建时间从新到旧排列——其他所有工具都需要使用这些项目 ID。。
misardev://templates	可用的入门模板，确保新项目基于实际模板创建。。
misardev://plan	当前套餐以及本周期剩余的构建、编辑和项目额度——可作为查询任何配额问题的基准。。

Agent 技能

收录于 skills/ — 当任务符合条件时，Agent 会加载相应指南。

技能	使用场景
connect-custom-domain	将用户拥有的域名关联到已发布的 MisarDev 项目，并指导用户配置 DNS 记录，直至 TLS 生效。适用于“使用我自己的域名”、自定义域名设置，或域名尚未提供服务的情况。
search-the-codebase	根据 MisarDev 项目的索引代码回答问题，并引用所用文件。适用于用户询问某项功能的工作原理、代码所在位置，或要求解释 MisarDev 项目中的某个部分。
ship-a-project	根据模板创建 MisarDev 项目并发布，验证发布前的地址和上线后的站点。适用于用户要求在 MisarDev 中启动、构建、上线或部署项目。
undo-a-bad-change	将 MisarDev 项目回滚到较早的检查点；如果项目已发布，则重新部署恢复的版本。适用于用户表示某项更改导致问题、想恢复之前的版本，或要求撤销操作。

---

安全

破坏性且不可逆的操作会标注（destructiveHint），以便 客户端在执行前提示。技能会指导 Agent 在执行任何发送邮件、发布内容或以其他方式 向他人公开的操作前进行确认。

发现（initialize、tools/list、prompts/list、resources/list） 无需凭据，因此注册表可以在没有凭据的情况下为该服务编制索引。 所有操作均需要凭据。

---

链接

• 网站 — https://misar.dev
• 应用 — https://misar.dev
• 文档 — https://docs.misar.io/dev/mcp
• Smithery — https://smithery.ai/server/misar/misardev-mcp
• npm — https://www.npmjs.com/package/@misardev/mcp
• 源代码 — https://github.com/Misar-AI/misardev-mcp

MIT © Misar.AI