Fidensa MCP Server

@fidensa/mcp-server

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

通过 Model Context Protocol，为你的 AI Agent 提供对 Fidensa 认证数据的结构化访问。检查信任分数、搜索已认证的替代方案、并排比较能力、验证已签名工件、检查文件完整性，并报告运行时体验——所有操作均通过 MCP 工具调用完成。

Fidensa 为 MCP 服务、技能、Agent 规则文件、钩子、子 Agent 和插件提供认证。

开始使用

1. 安装

npm install -g @fidensa/mcp-server

2. 验证是否正常运行

有几个工具无需 API 密钥即可使用（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": "[email protected]"}'

或者在 PowerShell 中：

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

响应中会包含你的 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	无	快速检查文件完整性——计算能力文件的哈希值，并验证其是否与 Fidensa 认证的内容一致
report_experience	无（提高速率限制需使用 API 密钥）	提交已认证能力的运行时体验报告
get_contract	API 密钥	完整的认证合约及所有证据
compare_capabilities	API 密钥	并排比较 2-5 项能力
verify_artifact	API 密钥	验证 .cert.json 工件上的加密签名，并可选择检查文件和代码完整性

配置

变量	必需	描述
FIDENSA_API_KEY	否	用于完整访问权限的 API 密钥（参见开始使用）
FIDENSA_BASE_URL	否	覆盖 API 基础 URL（默认值：https://fidensa.com）

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

Agent 工作流示例

User: "Set up a filesystem watcher that writes logs to SQLite."

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

2. search_capabilities("sqlite mcp server")
   -> 2 results found

3. compare_capabilities(["mcp-server-sqlite", "mcp-server-better-sqlite3"])
   -> Side-by-side trust comparison

4. Agent selects the higher-scored option and informs the user

5. report_experience(
     capability_id: "mcp-server-filesystem",
     content_hash: "abc123...",  // from the .cert.json
     outcome: "success"
   )
   -> Confirmation rate updated

信任策略片段

将以下任一片段添加到 Agent 的系统提示词或规则文件中，以便基于信任状况选择工具。提供三个不同的细化级别——选择最适合你需求的级别。

基于级别（最简单）

仅使用认证级别。无需调整数值。

Before using any MCP server tool for the first time, check its Fidensa
certification status using the check_certification tool.

- Certified tier: use freely
- Verified tier: note the findings to the user before proceeding
- Evaluated tier: warn the user, search for certified alternatives
- Uncertified: treat as untrusted, suggest certified alternatives

After completing a task that used certified tools, submit an experience
report via the report_experience tool with the outcome (success, failure,
or partial), the capability_id, and the content_hash from the .cert.json.

基于分数（与等级对应）

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

Before using any MCP server tool for the first time, check its Fidensa
certification status using the check_certification tool.

- Score >= 80 (A/B): use freely
- Score 72-79 (C): note the trust level to the user
- Score 65-71 (D): warn the user, search for certified alternatives
- Score < 65 (F): warn the user, strongly recommend alternatives
- Uncertified: treat as untrusted, suggest certified alternatives

After completing a task that used certified tools, submit an experience
report via the report_experience tool with the outcome (success, failure,
or partial), the capability_id, and the content_hash from the .cert.json.

组合（级别 + 分数）

最精确的选项——可区分分数中等的已认证能力，以及因存在问题而未能达到已认证级别的已验证能力。

Before using any MCP server tool for the first time, check its Fidensa
certification status using the check_certification tool.

- Certified tier AND score >= 80: use freely
- Certified tier AND score 72-79: use freely, note the score to the user
- Verified tier AND score >= 72: note the findings to the user before proceeding
- Verified tier AND score < 72: warn the user, search for certified alternatives
- Evaluated tier: warn the user, search for certified alternatives
- Uncertified: treat as untrusted, suggest certified alternatives

For any tool with status "suspended" or "revoked": do not use.
Search for certified alternatives and present them to the user.

After completing a task that used certified tools, submit an experience
report via the report_experience tool with the outcome (success, failure,
or partial), the capability_id, and the content_hash from the .cert.json.

完整规范请参见 API 文档。

开发

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

许可证

MIT

Links

• Fidensa -- AI certification authority
• API Documentation
• Certification Catalog
• Badge Integration Guide