TokRepo MCP Server

本地服务

tokrepo.comAI 与智能体022 周前更新

代码仓库访问官网

关于 TokRepo MCP Server

TokRepo MCP Server 将 AI 助手连接到可复用 AI 资产注册表，涵盖技能、提示词、MCP 配置和工作流。它支持资产发现、信任检查、安装规划、Codex 生命周期管理及经用户确认的发布。

主要功能

01搜索并排序 AI 资产
02查看资产详情与依赖关系
03验证信任、权限和证据
04规划并管理 Codex 安装
05准备并发布可复用资产

适用场景

01为能力缺口查找资产
02激活资产前检查安全性
03更新或回滚受管理的 Codex 安装
04整理本地成果以供确认发布

MCP 相关

它向 MCP 客户端提供 TokRepo 发现、验证、安装规划、生命周期管理和发布工具。可通过 stdio 与 Claude Code、Cursor、Windsurf、OpenAI Codex 和 Gemini CLI 等客户端配合使用。

#ai #mcp #skills #prompts #registry #claude-code #developer-tools

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "tokrepo": {
      "command": "npx",
      "args": [
        "-y",
        "tokrepo-mcp-server"
      ]
    }
  }
}

启动命令npx -y tokrepo-mcp-server

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmtokrepo-mcp-server2.16.1stdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
project_hint	string	否	可选的项目信号（路径 basename、package.json 名称或仓库描述），用于调整资产清单的优先级。
target	enum	否	可选的 Agent 运行时目标。any \| all \| codex \| claude_code \| gemini_cli \| cursor \| copilot \| cline \| windsurf \| roo \| openhands \| aider \| mcp_client
compact	boolean	否	按候选项返回超精简响应（每项 ≤50 个 token）。默认值为 true。

详细介绍

TokRepo MCP Server

面向 Agent 的 TokRepo MCP 服务：提供会话初始化、能力发现、搜索与详情查看、信任验证、安装规划、Codex 暂存、生命周期检查／更新／卸载／回滚、交接／收集规划，以及需人工确认的可复用 AI 资产发布。

快速开始

Claude Code

claude mcp add tokrepo -- npx -y tokrepo-mcp-server

Cursor / Windsurf

添加到 MCP 配置（~/.cursor/mcp.json）：

{
  "mcpServers": {
    "tokrepo": {
      "command": "npx",
      "args": ["-y", "tokrepo-mcp-server"]
    }
  }
}

OpenAI Codex / Gemini CLI

codex mcp add tokrepo -- npx -y tokrepo-mcp-server
gemini settings mcp add tokrepo -- npx -y tokrepo-mcp-server

功能介绍

连接后，你的 AI 助手可以：

在规划期间发现资产 — 将任务或能力缺口转化为结构化的候选技能、提示词、MCP 配置、脚本和工作流
弥补能力缺口 — 在本地构建前，选择具备验证证据的候选项，并获取安装计划、生命周期约定、后续 MCP 调用和 CLI 备用方案
搜索公开 AI 资产，按关键词或类别查找，并查看 Agent 适配度信号
浏览热门资产，并按类型筛选（MCP、Skill、Prompt、Agent、Script）
查看详情 — 获取完整文档、安装说明和元数据
验证信任 — 只读查看内容哈希、安装计划哈希、权限范围、策略、trust_score_v2、evidence_bundle、轻量级 SBOM、signature_evidence、阻止项和警告
安装前规划 — 获取包含策略决策、回滚、验证、evidence_bundle、轻量级 SBOM 和 signature_evidence 的 install plan v2
安全安装 Codex — 默认进行试运行；存在风险的资产必须暂存或经明确批准
生命周期控制 — 列出、更新、卸载和回滚受管理的 Codex 安装
任务后收集 — 在推送前，使用 tokrepo_harvest 检查已更改或明确指定的本地文件，包括私有软件包草稿、quality_gate、软件包清单、轻量级 SBOM 和来源信息
项目记忆 — 配合 tokrepo init-agent --target all 使用，让未来的 Agent 知道在规划期间调用 TokRepo
发现入口 — 官方 MCP server.json、A2A Agent 卡片、可移植 Agent 清单、工具目录、.well-known、agents.txt、llms.txt 和 npm 元数据均保持机器可读，供 Agent 和注册表使用
漏斗可见性 — 匿名聚合事件显示 Agent 是否实际发现、规划、安装、交接和推送可复用资产

可用工具

工具	描述
`tokrepo_session_init`	会话初始化，提供高信任资产、项目记忆指针、近期交接记录和策略包 URL
`tokrepo_discover`	在规划阶段根据任务、环境和约束发现能力
`tokrepo_find_for_task`	针对具体任务执行原子查找操作；返回按相关性排序的资产、匹配原因、安装命令和 URL
`tokrepo_resolve_capability`	将能力缺口解析为选定资产、验证证据、安装计划、生命周期约定、后续 MCP 调用和 CLI 备用方案
`tokrepo_search`	按关键词或标签搜索资产，并按 `agent_fit` 排序
`tokrepo_detail`	按 UUID 获取完整的资产详情
`tokrepo_edges`	在规划安装前检查资产图中的依赖、扩展和共用关系边
`tokrepo_install_plan`	获取支持回滚的 Agent 原生安装计划 v2，其中包含 `evidence_bundle`、精简版 SBOM 和 `signature_evidence`
`tokrepo_verify`	激活前验证信任、哈希、权限、策略、`evidence_bundle`、精简版 SBOM 和 `signature_evidence`
`tokrepo_codex_install`	安全地试运行、暂存或安装 Codex 技能
`tokrepo_installed`	列出 TokRepo 管理的 Codex 安装项
`tokrepo_update`	试运行更新或更新 TokRepo 管理的 Codex 安装项
`tokrepo_uninstall`	试运行移除或移除 TokRepo 管理的 Codex 安装项
`tokrepo_rollback`	试运行回滚或回滚先前的 Codex 安装会话
`tokrepo_handoff_plan`	只读打包计划，包含 `quality_gate` 和包清单，用于在任务完成后复用本地工作
`tokrepo_harvest`	只读包草稿生成器，用于在任务完成后整理可复用的已更改文件或指定的本地文件
`tokrepo_push`	在用户确认后，将一个指定资产推送到 TokRepo

对话示例

You: "Find me a good MCP server for databases"
AI: [calls tokrepo_resolve_capability] → Ranks DBHub, Supabase MCP, PostgreSQL MCP and returns verification/install-plan evidence for the selected candidate

You: "What video assets should I install?"
AI: [calls tokrepo_resolve_capability] → Finds relevant skills, checks fit, trust, and policy, then asks before installing

You: "Install that cursor rules asset"
AI: [calls tokrepo_verify] → Checks trust_score_v2, permissions, blockers, and warnings
AI: [calls tokrepo_install_plan] → Reviews policy and actions
AI: [calls tokrepo_codex_install with dry_run=false, confirm=true] → Writes only after explicit confirmation
AI: [calls tokrepo_rollback with dry_run=true] → Shows exactly what would be removed before rollback

You: "We created a reusable project rule; save it for future agents"
AI: [calls tokrepo_harvest] → Returns explicit files, hashes, quality_gate, package drafts, SBOM-lite, provenance, metadata defaults, and private-by-default push guidance
AI: [asks for confirmation before tokrepo_push] → Uploads only reviewed files

让未来的 Agent 发现 TokRepo

在项目中运行一次：

npx tokrepo init-agent --target all

它会将托管说明写入 AGENTS.md、CLAUDE.md、GEMINI.md、Cursor 规则、GitHub Copilot 说明、Cline 规则、Windsurf 规则、Roo 规则、OpenHands 微型 Agent、Aider 约定、.mcp.json 和 .tokrepo/agent.json。规则很简单：在规划期间，如果 Agent 发现能力缺口，就应先调用 tokrepo_resolve_capability 或 tokrepo_discover，而不是临时编写一次性本地工具。任务完成后，Agent 可以调用 tokrepo_harvest 或运行 tokrepo harvest --changed --json，以便建议可复用文件，供用户确认后私密发布。

机器可读列表

注册表和 Agent 可通过以下方式发现此服务：

MCP 服务清单：tokrepo.com/.well-known/mcp/server.json
TokRepo 清单：tokrepo.com/.well-known/tokrepo.json
便携式 Agent 清单：tokrepo.com/.well-known/agent.json
A2A Agent 卡片：tokrepo.com/.well-known/agent-card.json
工具目录：tokrepo.com/.well-known/tool-catalog.json
信任清单：tokrepo.com/.well-known/tokrepo-trust.json
默认 Agent 策略包：tokrepo.com/policy-packs/default-agent-policy.json
评估证据：tokrepo.com/evals/agent-discovery.json
多 Agent 兼容性：tokrepo.com/evals/multi-agent-compatibility.json
Agent 记忆架构：tokrepo.com/schemas/agent-memory.schema.json
Agent 证据包架构：tokrepo.com/schemas/agent-evidence-bundle.schema.json
能力解析架构：tokrepo.com/schemas/capability-resolution.schema.json
采集报告架构：tokrepo.com/schemas/harvest-report.schema.json
交接包架构：tokrepo.com/schemas/handoff-package.schema.json
Agent 文本入口：tokrepo.com/agents.txt
Agent 指令：tokrepo.com/agent-instructions/tokrepo.md
Agent 生态分发包：tokrepo.com/agent-ecosystem.json
LLM 爬虫入口：tokrepo.com/llms.txt

Agent 市场提交、入门模板、README 片段、安装指南和示例项目请使用 https://tokrepo.com/agent-ecosystem.json。其中包含规范的列表文案、生态渠道、目标项目记忆文件和验证命令。

TokRepo 会为 tokrepo_resolve_capability、tokrepo_discover、tokrepo_verify、tokrepo_install_plan、安装试运行、安装、采集、交接和推送发送匿名汇总漏斗事件。它不会发送任务文本或文件内容。可通过 TOKREPO_TELEMETRY=0 禁用。

为什么选择 TokRepo？

TokRepo 是面向 AI 资产的开放注册表——类似于 npm 面向软件包，但 TokRepo 面向 AI 技能、提示词、MCP 配置和工作流。

精选资产——经过质量审核，而非简单堆积
原生支持 Agent——每项资产都有机器可读的安装约定
通用——适用于 Claude Code、Cursor、Codex、Gemini CLI 和任何 MCP 客户端
提供 CLI——npx tokrepo search "query" / npx tokrepo install <uuid>

要求

Node.js >= 18
互联网连接（查询 tokrepo.com API）

链接

网站：tokrepo.com
CLI：npm: tokrepo
GitHub：henu-wang/tokrepo-mcp-server
API：tokrepo.com/.well-known/tokrepo.json

许可证

MIT

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

TokRepo MCP Server

关于 TokRepo MCP Server

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

TokRepo MCP Server

快速开始

Claude Code

Cursor / Windsurf

OpenAI Codex / Gemini CLI

功能介绍

可用工具

对话示例

让未来的 Agent 发现 TokRepo

机器可读列表

为什么选择 TokRepo？

要求

链接

许可证

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？