MCP Server

🛡️ Fidensa MCP Server

用于 Fidensa 的 MCP 服务器 —— 独立的 AI 能力认证机构。

通过模型上下文协议（Model Context Protocol），为你的 AI agent 提供对 Fidensa 认证数据的结构化访问。检查信任分数、搜索已认证的替代方案、并排比较能力、验证签名制品、检查文件完整性，以及报告运行时体验 —— 全部通过 MCP 工具调用完成。

Fidensa 认证范围涵盖 MCP 服务器、技能（skills）、agent 规则文件、钩子（hooks）、子 agent 及插件。

🚀 快速开始

1️⃣ 安装

npm install -g @fidensa/mcp-server

2️⃣ 验证运行

有若干工具无需 API key 即可使用（check_certification、search_capabilities、verify_file 和 report_experience）。启动服务器并确认它已连接到生产 API：

fidensa-mcp-server

你应该会看到：

[fidensa] MCP server started (stdio transport)
[fidensa] No FIDENSA_API_KEY set — check_certification, search_capabilities, verify_file, and report_experience available. Set FIDENSA_API_KEY for full access.

按 Ctrl+C 停止。

3️⃣ 获取 API 密钥（可选，免费）

其余工具（get_contract、compare_capabilities、verify_artifact）需要一个免费的 API 密钥。API 密钥还能为 report_experience 提供更高的速率限制。注册一个：

curl -X POST https://fidensa.com/v1/keys \
  -H "Content-Type: application/json" \
  -d '{"display_name": "My Agent", "email": "you@example.com"}'

或使用 PowerShell：

Invoke-RestMethod -Uri "https://fidensa.com/v1/keys" -Method Post -ContentType "application/json" -Body '{"display_name": "My Agent", "email": "you@example.com"}'

响应中包含你的 API 密钥（以 fid_ 为前缀）。请妥善保管 —— 它仅显示一次。

4️⃣ 添加到你的 Agent

选择你的平台，并添加 MCP 服务器配置：

Claude Desktop / Claude Code

{
  "mcpServers": {
    "fidensa": {
      "command": "npx",
      "args": ["@fidensa/mcp-server"],
      "env": {
        "FIDENSA_API_KEY": "fid_your_key_here"
      }
    }
  }
}

Cursor（.cursor/mcp.json）

{
  "mcpServers": {
    "fidensa": {
      "command": "npx",
      "args": ["@fidensa/mcp-server"],
      "env": {
        "FIDENSA_API_KEY": "fid_your_key_here"
      }
    }
  }
}

Windsurf / VS Code

{
  "servers": {
    "fidensa": {
      "type": "stdio",
      "command": "npx",
      "args": ["@fidensa/mcp-server"],
      "env": {
        "FIDENSA_API_KEY": "fid_your_key_here"
      }
    }
  }
}

如果你只需要开放层级的工具，可省略 FIDENSA_API_KEY 这一行。

💡 Claude Desktop 提示

通过 Settings → Developer → Edit Config 访问配置文件。保存后，请彻底退出并重新打开 Claude Desktop（右键点击系统托盘图标并选择 Quit —— 仅关闭窗口是不够的）。

🧰 工具列表

⚙️ 配置

check_certification、search_capabilities、verify_file 和 report_experience 无需任何配置即可使用。其余工具需要 FIDENSA_API_KEY。

💡 示例 Agent 工作流

用户："帮我配置一个把日志写入 SQLite 的文件系统监控器。"

Agent:
1. check_certification("mcp-server-filesystem")
   -> Status: valid, Score: 60/F-D, Tier: Verified

2. search_capabilities("sqlite mcp server")
   -> 找到 2 个结果

3. compare_capabilities(["mcp-server-sqlite", "mcp-server-better-sqlite3"])
   -> 并排信任比较

4. Agent 选择得分更高的选项，并告知用户

5. report_experience(
     capability_id: "mcp-server-filesystem",
     content_hash: "abc123...",  // from the .cert.json
     outcome: "success"
   )
   -> 确认率已更新

📋 信任策略片段

将以下片段之一加入你的 agent 系统提示词或规则文件，以实现感知信任的工具选择。共提供三个精细度级别 —— 选择最符合你需求的那个。

🏷️ 基于层级（最简单）

仅使用认证层级，无需调节任何数值。

在首次使用任何 MCP 服务器工具之前，请使用 check_certification 工具
检查其 Fidensa 认证状态。

- Certified 层级：可自由使用
- Verified 层级：在继续之前，向用户说明发现的问题
- Evaluated 层级：警告用户，并搜索已认证的替代方案
- Uncertified：视为不可信，建议使用已认证的替代方案

在完成使用已认证工具的任务后，请通过 report_experience 工具提交体验
报告，包含结果（success、failure 或 partial）、capability_id，
以及来自 .cert.json 的 content_hash。

📊 基于分数（与等级对齐）

使用信任分数，与 Fidensa 的等级定义对齐。

在首次使用任何 MCP 服务器工具之前，请使用 check_certification 工具
检查其 Fidensa 认证状态。

- Score >= 80 (A/B)：可自由使用
- Score 72-79 (C)：向用户说明信任级别
- Score 65-71 (D)：警告用户，并搜索已认证的替代方案
- Score < 65 (F)：警告用户，并强烈推荐替代方案
- Uncertified：视为不可信，建议使用已认证的替代方案

在完成使用已认证工具的任务后，请通过 report_experience 工具提交体验
报告，包含结果（success、failure 或 partial）、capability_id，
以及来自 .cert.json 的 content_hash。

🎯 组合（层级 + 分数）

最精确的选项 —— 可区分分数中等的 Certified 能力，与因存在问题而未能达到 Certified 层级的 Verified 能力。

在首次使用任何 MCP 服务器工具之前，请使用 check_certification 工具
检查其 Fidensa 认证状态。

- Certified 层级 且 score >= 80：可自由使用
- Certified 层级 且 score 72-79：可自由使用，并向用户说明分数
- Verified 层级 且 score >= 72：在继续之前，向用户说明发现的问题
- Verified 层级 且 score < 72：警告用户，并搜索已认证的替代方案
- Evaluated 层级：警告用户，并搜索已认证的替代方案
- Uncertified：视为不可信，建议使用已认证的替代方案

对于状态为 "suspended" 或 "revoked" 的任何工具：请勿使用。
请搜索已认证的替代方案，并将其呈现给用户。

在完成使用已认证工具的任务后，请通过 report_experience 工具提交体验
报告，包含结果（success、failure 或 partial）、capability_id，
以及来自 .cert.json 的 content_hash。

完整的规范说明请参见 API 文档。

🔧 开发

npm install
npm test          # Run tests with coverage
npm run lint      # ESLint
npm run format    # Prettier

📄 许可证

MIT

🔗 相关链接

• Fidensa —— AI 认证机构
• API 文档
• 认证目录
• 徽章集成指南