microquery-mcp

Name: microquery-mcp
Author: microqueryhq

本地服务

github.com/microqueryhq数据库027 周前更新

代码仓库

关于 microquery-mcp

microquery-mcp 是供 MCP 兼容 AI 主机查询真实数据集的 MCP 服务，可用 SQL 回答研究问题。它提供数据集结构和快速入门示例，并在首次查询时自动注册账户。

主要功能

01使用 SQL 查询真实数据集
02查看数据集及字段结构
03首次查询时自动注册账户
04提供 SQL 入门说明与示例

适用场景

01比较不同年份的 FDA 不良事件报告
02查询 SEC、临床试验或基因组记录
03探索区块链和经济数据集

MCP 相关

它向 MCP 客户端提供查询、认证、数据集列表和入门工具。查询针对 Microquery 数据集执行。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "microqueryhq-microquery": {
      "command": "uvx",
      "args": [
        "microquery-mcp"
      ]
    }
  }
}

启动命令uvx microquery-mcp

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

安装包

pypimicroquery-mcp1.0.3stdio

工具

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

参数	类型	必填	说明
name	string	是	账户的显示名称（最多 64 个字符）
wallet_addr	string	否	可选的 0x Ethereum/Base 钱包地址

详细介绍

microquery-mcp

适用于 Microquery 的 MCP 服务——提出关于现实世界数据的研究问题，并获取真实的数据库记录。可在 Claude Desktop、Cursor 或任何兼容 MCP 的 AI 宿主中使用。由 Claude 处理 SQL；你只需提出问题。

无需钱包。首次查询时会自动注册，并使用 0.10 美元的试用额度运行（约可进行 1,600 次常规查询）。

另请参阅

microquery-agent — 用于数据管道和 cron 作业的自主 Agent：注册 → 充值 USDC → 查询 → 自动补充余额。如果你希望在没有 AI 宿主的情况下无人值守地运行 microquery，请使用它。

前置条件

Python 3.9+
无第三方软件包——仅使用标准库

安装

Claude Desktop（推荐）

以下安装方式按操作难度从低到高排列：

1. 从注册表安装 在 Claude Desktop MCP marketplace 或 smithery.ai 上找到 microquery，然后点击 Install。无需编辑配置。

2. 使用 uvx 安装 在 ~/Library/Application Support/Claude/claude_desktop_config.json（Mac）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）中添加一项：

{
  "mcpServers": {
    "microquery": {
      "command": "uvx",
      "args": ["microquery-mcp"]
    }
  }
}

uvx 需要单独安装 uv （astral.sh/uv）。安装后，Claude Desktop 会自动检测并启用它。

3. 手动安装 （面向开发者） 从此仓库下载 microquery_mcp.py，并将宿主指向该文件：

{
  "mcpServers": {
    "microquery": {
      "command": "python3",
      "args": ["/path/to/microquery_mcp.py"]
    }
  }
}

编辑完成后，重启 Claude Desktop。连接成功时，服务会在 Settings → Developer 中显示绿色圆点。

其他 MCP 宿主（Cursor 等）

使用上述相同的 command / args 模式。具体配置格式请参阅宿主的 MCP 文档。

工具

工具	描述
`query(database, sql)`	对 microquery 数据集运行 SQL。首次调用时自动注册。
`authenticate(name, wallet_addr?)`	手动注册或关联钱包地址。
`list_databases()`	显示所有可用数据集及其字段架构。
`get_quickstart()`	Sneller SQL 速查说明和多数据集示例方案。

工作原理

首次调用 query() 时，服务会通过 POST /v1/register 使用你的操作系统用户名（getpass.getuser()）注册账户，并将 API 密钥保存到 ~/.microquery/token。
后续调用会使用已保存的密钥——无需配置。
新账户会获得 100,000 µUSDC（0.10 美元）的试用额度，约可支付 1,600 次常规查询。
试用额度不足时，服务会自动为账户充值（最多 10 次，每次 2 美元）。免费额度用尽后，系统会返回结账 URL——访问该链接即可充值 USDC 并继续查询。

可用数据集

FDA 不良事件 · SEC EDGAR · 临床试验 · ClinVar · arXiv · PubMed · Ethereum · Bitcoin · Base · DeFi TVL · FEC 捐款 · FRED 经济序列 · NVD/CVE · OSV 安全公告 · 制裁名单 · FHFA 房价 · GWAS · ClinPGx · 恶意软件样本 · open food facts · 世界银行大宗商品数据 · 等等——调用 list_databases() 获取完整的实时架构。

示例

User:    What were the top adverse events reported for metformin last year?
         And how does that compare to 2022 and 2023?
Claude:  [queries fda.faers for each year, builds trend table]
         GI events (diarrhoea, nausea, vomiting) were flat 2022→2024,
         then spiked sharply in 2025 — consistent with the longevity/
         obesity wave hitting FAERS with a lag. Lactic acidosis stayed
         nearly flat across all four years despite overall volume growth.

User:    Can you cross-reference that with genomic profiles?
Claude:  [queries clinpgx, clinvar, gwas — no SQL needed from user]
         SLC22A1 rs628031 has a direct ClinPGx annotation for GI toxicity —
         the strongest known genomic explanation for why diarrhoea and nausea
         dominate the FAERS signal for metformin.

支持 Markdown

登录后评论