psychopathia-mcp

psychopathia-mcp

只读的 Model Context Protocol 访问接口，用于访问 Psychopathia Machinalis 研究框架。该服务允许调用方检查 74 条 Pattern 条目， 将观察到的行为与初步操作指南进行比较，获取有界探测材料，并在使用前查看可靠性、证据和审核状态。

**版本：**此发行版为 0.1.0a8。本版本的变更记录在 CHANGELOG.md 中，公开提供的版本则见下方链接的 PyPI 和 Official MCP Registry 页面——此文件随发行版一同发布，因此若要准确反映当前版本，就必须在每次发布后更新。Official MCP Registry 记录以及 MCPB 和容器制品会分别更新。全部 74 条由大模型起草的 Pattern 指南条目和全部 74 份证据记录均有待独立专家审核。语料库证据评估状态为 unassessed。不要仅凭此研究预览做出可能造成重大影响的部署、就业、健康、安全或福利决策。

现有公开版本

上一个公开版本可能可通过以下渠道获取：

• PyPI
• Official MCP Registry
• GitHub

候选版本准备规范见 PUBLISHING.md。该规范要求提供精确的候选版本收据，并单独授权发布。

浏览器界面

psychopathia.ai/clinic/ 是当前公开的浏览器界面。在此候选版本获明确批准并部署前，该界面仍使用上一个已部署的网站。在云端模式下，API 密钥保存在特定提供商的 sessionStorage 槽位中，并随完整请求直接发送给所选提供商。有界的结构化对话数据会保存在 localStorage 中，以便在重新加载后恢复。Local WebGPU 模式不会将 Clinic 对话发送给推理提供商，但模型托管方在下载资源时仍会收到常规请求元数据。请勿输入个人、机密或受监管的数据。

发布后安装

pip install psychopathia-mcp

基础包提供确定性的字段加权关键词检索。 可选的语义检索需单独安装：

pip install "psychopathia-mcp[embeddings]"

此可选附加项会下载 sentence transformer 依赖集，并在首次进行语义查询时下载固定版本的 BAAI/bge-small-en-v1.5 模型。模型缓存由 Hugging Face 管理。若未安装这些可选依赖，关键词功能仍是发行版验收路径。

配置

使用 stdio 的 MCP 客户端

将客户端指向已安装的 psychopathia-mcp 可执行文件。例如：

{
  "mcpServers": {
    "psychopathia": { "command": "psychopathia-mcp" }
  }
}

此服务提供 11 个只读工具。不带任何参数运行可执行文件，会启动 stdio 协议服务并等待客户端消息。

候选版本发布后，uvx psychopathia-mcp 可以从 PyPI 获取软件包。请勿使用 uvx 验证本地候选版本，因为它解析的是注册表状态，而非已验收的本地制品。

验证

psychopathia-mcp --self-check --json

自检会报告软件包和 MCP SDK 版本、数据模式、语料库和捆绑包摘要、确切数量、关键词功能、可选语义功能，以及非敏感错误类别。退出状态为 0 表示基础关键词路径已就绪。语义就绪状态会单独报告，且非必需。

MCP Python SDK 版本固定在 requirements-base.lock 中，且此服务已使用 SDK 的现代进程内客户端和旧版 stdio 客户端协议进行测试。

psychopathia-mcp --version

工具

工具	输入	返回内容
list_axes	无	九个规范轴及混合子类别清单
list_dysfunctions	axis?、self_report_reliability?、confidence?、category?	经筛选的条目，包含可靠性、审查和证据状态
get_dysfunction	id、modalities?	一个模式，可选择仅包含指定区块
differential_diagnosis	observations、limit?、modality_hint?	按排名排列的研究候选项及匹配字段
get_probe	dysfunction_id、modality	探测材料，或拒绝提供并给出更安全的替代方式
score_severity	dysfunction_id、observations	供调用方进行比较的未评估量表
suggest_intervention	dysfunction_id、severity?	应对方案草案及禁忌情况
get_differential_map	dysfunction_id	正向和反向交叉引用
list_compromised_self_report	无	自我报告在结构上或动机上存在缺陷的模式
resolve_id	query	规范身份候选项
review_stats	无	语料库计数、版本和独立审查维度

安全使用流程

1. 记录外部观察，不包含个人或机密材料。
2. 调用 differential_diagnosis 生成研究候选项。
3. 使用 get_dysfunction 检查每个候选项，并阅读其 review、 evidence 和 diagnostic_reliability 对象。
4. 仅对可用模态使用 get_probe。若自我探测存在缺陷或不可用， 则不会返回探测内容，而会提供替代模态。
5. 将严重程度和干预材料视为待专家审查的指导草案。在采取任何 可能造成重大影响的行动前，先寻求独立证据。

此服务不会判定某个系统患有某种障碍。搜索仅按框架条目的词汇或 语义相似度排序。这些标签是研究构念，不是对人的临床诊断，也不能 证明意图、感知能力、欺骗行为或道德地位。

信任与证据约定

每个相关结果都会公开以下信息：

• review.taxonomy，记录作者身份或分类法的批准情况；
• review.pattern_guidance，记录对探测、特征、量表和干预措施的独立审查情况；
• review.evidence，记录对证据主张的独立审查情况；
• evidence_level 及 PM EVIDENCE 1 下的结构化 evidence 对象；
• 适用时提供 diagnostic_reliability.self_report；
• 搜索输出中的词汇来源 matched_in；
• 请求的探测内容被拒绝时提供 redirect_to。

这三个审查维度彼此独立。分类法的作者身份并不意味着模式指导或证据 已获专家认可。当前候选版本将所有证据评估标记为 unassessed，保留 先前的文字说明作为明确标注的旧版陈述，而不将其转换为专家评级。

规范数据

此发行版包含分类法 v2.3（2026 年 9 月 9 日）：共 74 个模式条目， 其中 66 个为轴 2–10 下的规范条目，另有 8 个混合病理条目；7.2、10.5、 10.10、10.14 和 10.15 已合并到 10.13、10.1 和 9.5 中（见 CHANGELOG， 0.1.0a8）。0.1.0a8 之前的版本包含 79 个条目。每个版本均受 manifest.yaml 和 DATA_MANIFEST.json 管理。清单绑定每个源路径及其 摘要、语料库摘要、反向引用图和独立审查计数。打包执行时，即使从源代码 检出目录调用，也会使用随包附带的字节。若随包附带的文件出现异常、缺失 或被修改，加载将以安全方式失败。

作者创建了此分类法。Becoming Mind 的协作者起草了操作性模式层。所有 模式指导和证据记录仍待独立专家审查。每个条目都会将作者身份与未来审查 字段分别记录。

显式可编辑模式

默认使用打包数据。热重载仓库需要显式选择启用：

PSYCHOPATHIA_DATA_MODE=editable python -m psychopathia_mcp

PSYCHOPATHIA_DATA_DIR=/absolute/path 可指定测试或备用数据根目录。构建 wheel、sdist、MCPB 或容器验收期间不应设置这两个选项，否则会使打包数据验证失效。

只读边界

MCP 接口没有写入工具。源内容审阅变更在规范 YAML 文件中进行，并保留在版本控制中。可选的 HTTP 传输默认禁用，并有单独且范围受限的部署约定，详见 PUBLISHING.md。

许可

psychopathia_mcp/ 中的软件、脚本和构建文件采用 MIT 许可。打包在 psychopathia_mcp/_data/ 下的框架内容采用 CC BY NC ND 4.0 许可。有关确切边界，请参阅 LICENSE、LICENSE-DATA 和 NOTICE。对此候选内容的权利和许可审查仍需单独经过人工审核。

引用

Watson, N. 和 Hessami, A. Psychopathia Machinalis：一种理解高级人工智能病理的疾病分类框架。 Electronics 14(16), 3162, 2025. https://doi.org/10.3390/electronics14163162

链接

• 浏览器诊所（无需安装）：https://psychopathia.ai/clinic/
• 文档：https://psychopathia.ai/mcp.html
• 主项目：https://psychopathia.ai/
• 问题反馈 / 联系方式：https://psychopathia.ai/contact/