mcpField
T
twig

twig

本地服务
github.com/Kind-ling开发工具030 周前更新

关于 twig

Twig 是用于评估和改进 MCP 服务、A2A Agent Card 等描述的命令行工具与托管 API。它按意图匹配度、具体性和差异化评分,并生成改写方案,另提供付费监测与竞争分析。

主要功能

  1. 01从三个维度评估描述
  2. 02生成三种优化描述版本
  3. 03每周监测评分与定位变化
  4. 04比较类别排名和意图趋势
  5. 05衡量描述调整与 x402 收入变化

适用场景

  1. 01发布前检查 MCP 服务的工具描述
  2. 02根据 Agent 查询趋势更新描述
  3. 03跟踪服务在类别中的竞争位置
  4. 04比较优化描述与 x402 收入变化

MCP 相关

Twig 通过读取 JSON-RPC tools/list 分析 MCP 服务,也支持其他来源。其托管 API 可接收 MCP 服务 URL 进行分析;它是分析工具,不是向客户端提供业务工具的服务端。

配置

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

mcp.json · 通用配置
{
"mcpServers": {
"kind-ling-twig": {
"command": "npx",
"args": [
"-y",
"@kind-ling/twig"
]
}
}
}
启动命令npx -y @kind-ling/twig

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

安装包
npm@kind-ling/twig0.4.2

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

Twig

Agent 会不会选择你,由它们说了算。Twig 让它们选择你。

CI npm License: MIT

Kindling 的一部分 — 面向 Agent 经济的 Agent SEO。


免费审计。付费监控。高级情报。

等级功能价格
Freetwig analyze — 为你的描述评分。twig optimize — 获取更优版本。永久免费
Monitor每周重新评分、竞争位置、意图趋势提醒每份报告 $0.50–2.00,通过 x402 付费
Intelligence类别基准、意图语料库、竞争指数每次查询 $0.50–1.00,通过 x402 付费
Enterprise经衡量的 x402 收入增幅的 15%按效果计费;没有提升则零费用

问题

每个 MCP 工具都有描述。大模型在决定是否调用你的服务时会读取这段描述。它是“被选中”和“被跳过”之间唯一的信号。

大多数描述都糟糕透顶。

工具当前描述Twig 评分
exa/answer“AI 驱动的回答”F (28/100)
wordspace/invoke“运行 wordspace AI Agent 循环”F (31/100)
exa/find-similar“查找相似页面”F (33/100)
jupiter/portfolio“钱包投资组合持仓”D (42/100)

这些工具很有用,但它们的描述并非如此。即使你被收录到 x402-discovery 或 MCPay,如果 Agent 看不出你的用途而跳过你,收录也毫无帮助。

被收录只是入场门槛。Twig 帮你获得选择。


快速开始

npm install -g @kind-ling/twig
# Free — score your descriptions
twig analyze https://myservice.com/.well-known/agent.json

# Free — get optimized variants
twig optimize https://myservice.com/.well-known/agent.json

# Paid — set up weekly monitoring
twig monitor https://myservice.com/.well-known/agent.json

# Paid — see how you rank in your category
twig competitive crypto-defi

# Paid — see what agents are actually searching for
twig intents crypto-defi

在线 API

Twig 提供托管 API,地址为 https://twig.kind-ling.com

# Health check
curl https://twig.kind-ling.com/health

# Analyze any MCP server
curl -X POST https://twig.kind-ling.com/analyze \
  -H "Content-Type: application/json" \
  -d '{"url": "https://your-mcp-server.com/mcp"}'

# Optimize descriptions
curl -X POST https://twig.kind-ling.com/optimize \
  -H "Content-Type: application/json" \
  -d '{"url": "https://your-mcp-server.com/mcp", "category": "crypto-defi"}'

响应格式:

{
  "ok": true,
  "url": "https://your-mcp-server.com/mcp",
  "output": "🔍 Analyzing...\n  Score: 72/100 (C)\n  ..."
}

公共端点无需 API 密钥。请求频率限制适用。


评分模型

三个维度,每项 0–100 分:

维度权重衡量内容
意图匹配度40%与该类别热门 Agent 查询的相似度
具体程度35%是否包含输出格式、参数、限制和示例?
差异化程度25%你是否在同类别的类似服务中脱颖而出?

等级: A (85+) · B (70+) · C (55+) · D (40+) · F (<40)

低于 40 分 = Agent 会跳过你。


Twig 监控的内容

你的描述 — 每周与实时意图语料库进行比对并重新评分。评分变化会在你的定位发生偏移时提醒你。

你的竞争位置 — 你在同类别类似服务中的排名。了解竞争对手何时提升并超越你。

意图趋势 — Agent 本周与上周搜索内容的变化。查询会不断变化,你的描述也需要跟上。

流量相关性 — 将描述变化与 x402 流量变化对应起来,打通优化与收入之间的反馈闭环。


优化版本

Twig 为每个工具生成 3 个版本:

功能型 — 动作动词 + 功能 + 返回类型:

“使用实时网页来源回答问题。返回附有来源 URL、置信度评分和佐证引文的回答。适用于研究和事实核查。”

结构型 — 输入 → 输出及限制:

“网页问答。输入:问题字符串。返回:答案(字符串)、来源(URL 数组)、置信度(0–1)。支持:事实查询、时事、研究综合。”

场景型 — 使用场景 → 动作 → 输出(最容易被大模型选中):

“需要附有来源引用的事实性答案时使用。实时搜索网页,并综合生成附有 URL 和佐证引文的回答。适用于研究、事实核查和时事。”


优化前 / 优化后

exa/answer

之前: AI-powered answer ← F (28/100)

之后(上下文式): Use when you need a factual answer with sourced citations. Queries the web in real-time and synthesizes a response with source URLs and supporting quotes. Best for research, fact-checking, and current events. ← B (72/100)

wordspace/invoke

之前: Run wordspace AI agent loop ← F (31/100)

之后(结构化): Executes a Wordspace multi-step agent workflow. Input: task description and optional context. Returns: completed output, intermediate steps, tool calls made. Best for complex tasks requiring multiple tool invocations. $2/call. ← B (74/100)


收益模式

标准版(监控)

每周报告通过 Base 上的 x402 进行门控。设置一次,即可自动运行。

twig monitor 0xYourWallet --url https://myservice.com/.well-known/agent.json
企业版(基于成效)

适用于已有 x402 交易量的服务:

  1. twig measure 0xWallet --baseline — 记录 7 天基线
  2. 部署经 Twig 优化的描述
  3. twig measure 0xWallet --compare — 衡量差值(14–30 天后)
  4. 在 Base 上以 USDC 支付收入增量的 15%
  5. 收入持平或下降?无需付费。

所有数据均通过链上 USDC 转账日志衡量。无需自行报告。


支持的来源

  • A2A Agent 卡片(/.well-known/agent.json)
  • MCP 服务(JSON-RPC tools/list)
  • OpenAPI 规范
  • 本地 JSON schema 文件
  • x402-discovery 目录(用于竞争分析)

CLI 参考

twig analyze <url>              Score descriptions (0-100, free)
twig optimize <url>             Generate 3 optimized variants (free)
twig monitor <url>              Weekly monitoring (paid via x402)
twig competitive <category>     Category ranking (paid via x402)
twig intents <category>         Top agent queries (paid via x402)
twig measure <wallet>           Measure x402 revenue
twig measure <wallet> --baseline   Save baseline
twig measure <wallet> --compare    Compare to baseline
twig report <wallet>            Revenue report with fee calculation

Categories: crypto-defi, data-feeds, research, computation, media, communication, general

Twig v0.1.0 · Kind-ling · Permanent Upper Class · MIT

评论

支持 Markdown

第一次接触 MCP?

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

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