gildara

Gildara MCP

一个提示词库。适用于每个 Agent。无需设置。 让 Claude、Cursor、Windsurf 和 Claude Code 共用一个可搜索的提示词库，并在不同对话、设备和工具间持久保存。

{ "mcpServers": { "gildara": { "command": "npx", "args": ["-y", "@gildara/mcp-server"] } } }

将内容粘贴到 claude_desktop_config.json，重启 Claude，即可在 Claude 的工具列表中看到 Gildara 工具。无需注册。无需 API 密钥。 服务会在首次运行时自动创建一个免费 Agent，并打印一个可稍后将其与你的帐户关联的一键链接代码。

→ 前往 gildara.io 开始使用 — 关联自动创建的 Agent，以同步你的提示词库并解锁 Pro。

---

AI 能做什么

• 语义搜索提示词 — 根据含义而不只是关键词查找（Gemini 嵌入）。
• 解析并运行提示词 — 组装包含操作契约章节的编译系统提示词，并在 JSON 架构验证失败时自动修复。
• 创建并追加内容 — 保存新提示词，或向记忆类型的提示词追加持久事实。
• 向 Agent 分派简报 — 说 “把这个发给 gevorg”，MCP 服务就会创建一份简报，以 .md 附件的形式发送到已关联的 Telegram 聊天，并 @提及目标 Agent 的机器人。一次调用即可完成从在聊天中勾勒想法，到在另一台设备上交给 Agent 处理，再到在聊天中收到结果的整个闭环。有关 Agent 端的集成步骤，请参阅 docs/briefs/dogfood-rollout-v0.md。
• 浏览 48+ 个蓝图 — 预构建的 Agent 模板。

设置

首次运行无需 API 密钥。 自 v0.6.0 起，如果未设置 GILDARA_API_KEY，MCP 服务会在首次启动时自动创建一个新的 Agent 帐户，并将密钥缓存到 ~/.gildara/auto-key.json，供后续运行使用。可跳过下方的“添加到 Claude Desktop”之前的内容，无需执行 curl。

首次运行时，服务会在 stderr 中打印一个链接代码（可在 Claude Desktop 的 MCP 日志中查看）。访问 https://gildara.io/link?code=XXXXXX，将自动创建的 Agent 与你的人类帐户关联，并继承你的订阅等级。

1.（可选）使用现有 API 密钥，而非自动创建

如果你愿意使用自动创建方式，可跳过本节。

否则，可通过以下任一方式获取密钥：

通过 API 手动创建：

curl -X POST https://gildara.io/api/v1/provision \
  -H 'Content-Type: application/json' \
  -d '{"agent_label": "my-agent"}'

通过网页获取： 前往 gildara.io/account，并使用 agent-standard 预设创建 API 密钥。

然后在 MCP 配置中设置 GILDARA_API_KEY（参见下方示例）。

2. 添加到 Claude Desktop

编辑 claude_desktop_config.json。自动创建时无需 env 块：

{
  "mcpServers": {
    "gildara": {
      "command": "npx",
      "args": ["-y", "@gildara/mcp-server"]
    }
  }
}

或者，使用现有密钥：

{
  "mcpServers": {
    "gildara": {
      "command": "npx",
      "args": ["-y", "@gildara/mcp-server"],
      "env": {
        "GILDARA_API_KEY": "pvk_your_key_here"
      }
    }
  }
}

3. 添加到 Cursor

一键安装：

或者手动安装：在项目根目录中编辑 .cursor/mcp.json，使用与 Claude Desktop 相同的配置（可包含或不包含 env 块，规则相同）。

4. 添加到 Claude Code

在终端中运行：

claude mcp add gildara -- npx -y @gildara/mcp-server

这里也支持自动创建。仅当你想使用现有密钥时，才需在环境中设置 GILDARA_API_KEY。

5. 添加到 Claude Chat（claude.ai）

Gildara 支持通过 HTTP/SSE 使用远程 MCP。

1. 在 Claude Chat 中前往 设置 > 连接器。
2. 选择 “添加自定义连接器”。
3. 名称： Gildara Vault。
4. 远程 MCP 服务 URL： https://gildara.io/api/mcp/mcp。
5. 身份验证： OAuth 2.1（系统会将你重定向到 Gildara 授权页面进行授权）。

工具

工具	描述
search_prompts	使用 Gemini 嵌入向量对你的知识库进行语义搜索
list_prompts	列出知识库中的所有提示词
get_prompt	获取提示词详情和操作契约配置
resolve_prompt	获取替换变量后的编译版系统提示词
run_prompt	使用 AI 运行提示词并自动修复
create_prompt	创建新的提示词
append_memory	向现有的记忆类型提示词添加信息
save_brief	将简报发送给指定 Agent（通过 Telegram 发送 MD 附件，@提及会将消息路由到相应的机器人）
list_blueprints	浏览 48+ 个 Agent 蓝图模板
get_account_link	获取链接，将此 Agent 的知识库关联到人工 Gildara 账户

使用示例

连接后，只需告诉你的 AI：

• “在我的知识库中搜索与安全审计相关的提示词。”
• “使用 code_diff 变量解析我的 code-review-agent 提示词。”
• “针对这段代码运行 security-audit 提示词。”
• “将此偏好追加到我的‘Personal Context’记忆中：相比 JavaScript，我更喜欢 TypeScript。”
• “将此内容发送给 gevorg：分析上周的 Meta Ads 效果，并标记表现最差的 3 个广告系列。”

本地优先支持

Gildara 采用本地优先架构。MCP 服务会自动将已解析的提示词缓存到 ~/.gildara/cache/，确保即使 Gildara API 暂时无法访问，你的 Agent 仍能正常运行。

环境变量

变量	必填	描述
GILDARA_API_KEY	否	你的 API 密钥（pvk_...）。若未设置，服务会在首次运行时自动创建新的 Agent 账户，并将密钥缓存到 ~/.gildara/auto-key.json。显式设置此变量以使用现有密钥。
GILDARA_BASE_URL	否	覆盖 API URL（默认值：https://gildara.io）。

许可证

MIT

---

贡献 / 维护者

此软件包是 stdio MCP 服务。同级的 HTTP 服务位于父级 monorepo 中的 app/api/mcp/[transport]/route.ts（为 Claude.ai 原生连接器提供支持）。两者必须保持一致，包括工具名称、参数架构和响应文本。

在此处添加、移除或修改工具之前，请阅读 docs/MCP_INTEGRATION_CONTRACT.md，并从 monorepo 根目录运行 npm run test:unit 以验证一致性。