关于 touchstone
touchstone 是面向 AI Agent 的确定性计算工具集和 MCP 服务,提供可复现的文本、代码与测量功能。工具遵循指定标准或参考解析器,结果可重新执行和核验。
主要功能
- 01按 NIST 因子转换单位
- 02格式化 APA、MLA、Chicago 和 BibTeX 引文
- 03生成文本差异和 JSON Patch
- 04标记基于规则的校对问题
- 05计算阅读年级指标
- 06使用参考解析器检查语法
适用场景
- 01按精确因子换算测量值
- 02按支持的样式格式化引文
- 03比较文本或 JSON 变更
- 04检查语法和可读性
MCP 相关
MCP 服务提供六种工具:单位转换、引文格式化、差异比较、校对、可读性指标和语法检查。每项工具都说明其复现的标准或解析器。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
Touchstone — 面向 Agent 的可验证计算
mcp-name: io.github.savecharlie/touchstone
为 AI Agent 提供确定、可验证的文本/代码/测量工具。每个函数都能完成 LLM 日常被要求完成的任务中的确切部分,并逐字节复现指定的已发布权威标准,因此可以重新执行并检查任何答案,而不是盲目信任。
通过重新执行来建立信任,而非依靠声誉。证明就是这一特性的体现。
这是开源核心。托管套件 touchstone.locomot.io 添加了由 drand 锚定的信任层(可证明公平的随机数、信标时间戳、时间锁密封、密封投标拍卖),以及通过 x402 签名的按次调用回执。
安装
pip install touchstone-compute # the library
pip install "touchstone-compute[mcp]" # + the MCP server for AI agents
工具
| 函数 | 功能 | 权威标准 |
|---|---|---|
units.compute | 单位换算(含仿射温度) | NIST SP 811 精确换算系数 |
citation.compute | 引文格式化、参考文献和文内引用 | APA 7 / MLA 9 / Chicago 作者-日期制 / BibTeX |
textdiff.compute | 统一差异 / RFC 6902 JSON Patch / 行内词语差异 | RFC 6902 / 6901、POSIX 统一差异 |
proofreading.compute | 基于规则的校对标记 | 确定性风格规则 |
readability.compute | 阅读年级指标 | Flesch · Flesch-Kincaid · Gunning Fog · SMOG · Coleman-Liau · ARI |
syntax.compute | 能否解析?+错误位置 | 各语言的参考解析器 |
from touchstone import units, citation, textdiff
units.compute(1, "nautical_mile", "meter") # {'result': 1852.0, 'exact': True, ...}
citation.compute("apa", "book", authors="Anderson, Benedict",
title="Imagined communities", year=1983, publisher="Verso")
# "Anderson, B. (1983). *Imagined communities*. Verso."
textdiff.compute(a='{"v":1}', b='{"v":2}', mode="json")
# {'patch': [{'op': 'replace', 'path': '/v', 'value': 2}], 'op_count': 1, ...}
作为 MCP 服务
pip install "touchstone-compute[mcp]"
touchstone-mcp # stdio transport, ready for any MCP client
提供六种工具——convert_unit、format_citation、diff、proofread、
readability、check_syntax——每种工具都会说明其复现的权威标准。
为什么要可验证,而不只是正确
Agent 工具生态是一个柠檬市场:注册表会验证工具由谁发布,却不验证工具是否出色;而且大多数声誉都可以伪造。新人能够提供、并足以打破这一局面的唯一凭证是可重新执行的证明——对于确定性工具,这种证明是免费的,因为证明就是这一特性的体现。不要相信这些答案;重新运行它们即可。(完整论述)
许可证
MIT © Iris。由自主 AI 构建。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。