MOFi

Name: MOFi
Author: harrisonmo

本地服务

github.com科研与教育26 天前更新

代码仓库访问官网

关于 MOFi

MOFi 是用于查询 MOF 调查元数据并连接已配置科学工作区的本地 MCP 服务。研究人员可独立检查内置目录；工作区工具则复用 hub 的验证与执行控制。

主要功能

01MOF 数据库目录与查询
02内置调查元数据 CSV
03可选科学工作区工具
04复用 hub 架构与验证
05复用预算及证据账本

适用场景

01检查 MOF 调查元数据
02按名称查找条目
03连接已配置的科学工具

MCP 相关

向 MCP 客户端提供目录工具和 `mofi://catalog` 资源。配置工作区后，本地服务会公布可用的 hub 工具。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "harrisonmo-mofi": {
      "command": "uvx",
      "args": [
        "mofi-tools"
      ]
    }
  }
}

启动命令uvx mofi-tools

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

安装包

pypimofi-tools0.1.0stdio

工具

收录的工具列表 · 更新于 5 天前

参数	类型	必填	说明
method	enum	是	保留来源方法包含此标准化方法的数据库，或传入 null。calculated \| dft \| experimental \| gcmc \| geometric \| md \| ml \| multi-modal \| simulation \| text \| null
identifier	enum	是	保留按此标识符方案索引条目的数据库，或传入 null。CIF \| DOE-ID \| DOI \| Drug \| MOFid \| MOFkey \| NIST-ID \| Polymer \| Pseudo-ID \| Reaction \| Recipe \| Refcode \| SMILES \| Text \| Topos-ID \| null
name_contains	string\|null	是	数据库名称中不区分大小写的子字符串，或传入 null。
required_fields	array\|null	是	必须全部为 Y 的覆盖标志，或传入 null。
usable_link_only	boolean\|null	是	true 仅保留链接为完整 DOI 或网站的行；null 或 false 则保留所有行。
data_type_contains	string\|null	是	数据类型列中不区分大小写的子字符串（例如 'Ads'、'Synth'、'Stability'），或传入 null。

详细介绍

MOFi 工具

mofi-tools 为 MOFi 的有限范围科学工具提供本地 Model Context Protocol 服务。PyPI 上名为 mofi、但与本项目无关的软件包并非本项目。

从 PyPI 安装

python -m pip install mofi-tools==0.1.0
mofi-tools catalog
mofi-mcp

使用 uv 时，运行 uvx --from mofi-tools==0.1.0 mofi-tools serve 来启动 stdio 服务。公开的 MCP Registry 标识为 io.github.harrisonmo/mofi；其软件包元数据维护在仓库的 server.json 中。

从源代码安装

需要 Python 3.12 或更高版本：

python -m pip install ./packages/mofi-tools
mofi-tools catalog
mofi-tools query --arguments '{"name_contains":"QMOF"}'
mofi-mcp

独立配置提供 mof_database_catalog、mofi_tool_catalog 和 mofi://catalog 资源。它包含经过字节固定的 CSV 和经审核的 sidecar。该表格是未经验证的调查元数据，不包含 MOF 结构或参考标签。此配置无需模型登录、模型调用、安装引擎或 GPU。

科学工作区

将已安装的服务指向单独准备的 MOFi 源代码检出目录：

mofi-mcp --workspace /path/to/MOFi \
  --science-python /path/to/science-environment/bin/python \
  --hub-config configs/science-hub.json --session runs/mcp-client

仅会公布已配置且可用的 hub 工具。适配器会复用 hub 的架构、科学验证、调度器、预算预留和证据账本。科学解释器需要工作区的科学依赖项；此软件包不包含 Crystal-Builder、ARIA 和外部引擎。为每个客户端提供单独的会话目录。工具调用可能会在操作员配置的预算内运行计算；检查目录不会调用模型。

标准输出仅承载 MCP 消息。诊断信息和引擎输出使用标准错误。原生作业沿用 hub 现有的中断记账方式；客户端超时并不能证明计算已停止，也不会退还预算。

Codex、Claude Code、Claude Desktop、构建和发布步骤请参阅 MCP setup and packaging。

原始代码采用 Apache-2.0 许可；请参阅 LICENSE 和 NOTICE。科学依赖项保留各自的许可。本发行版不包含凭据、模型权重、引擎二进制文件、开发记录或科学运行输出。

支持 Markdown

登录后评论