mcpField
M
mcp-cps-data MCP server

mcp-cps-data MCP server

本地服务
github.com/mdagost数据与分析098 周前更新

关于 mcp-cps-data MCP server

面向芝加哥公立学校数据的 MCP 服务,可查询本地 SQLite 和 LanceDB 数据库,涵盖学校与社区记录及学校网站内容检索。

主要功能

  1. 01查询学校与社区记录
  2. 02检索相关学校网站内容
  3. 03使用本地 SQLite 和 LanceDB 数据库

适用场景

  1. 01查找学校所属社区
  2. 02为学校相关问题收集网站信息

MCP 相关

向 MCP 客户端提供两个工具:查询学校与社区记录,以及检索相关学校网站内容。

配置

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

mcp.json · 通用配置
{
"mcpServers": {
"cps-data": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/inspector"
]
}
}
}
启动命令npx -y @modelcontextprotocol/inspector

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

安装包
npm@modelcontextprotocol/inspector

工具

还没有获取到工具列表

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

详细介绍

mcp-cps-data MCP 服务

一个 MCP 服务项目,用于公开包含芝加哥公立学校信息的本地 SQLite 数据库和本地 LanceDB 向量数据库

组件

工具

该服务实现了两个工具:

  • query_schools_and_neighborhoods:在名为 "schooltoneighborhood" 的芝加哥公立学校及其所在社区的表中执行 SELECT 查询,该表的架构如下:(id INTEGER NOT NULL, created_at DATETIME NOT NULL, school_id INTEGER NOT NULL, school_name VARCHAR NOT NULL, neighborhood VARCHAR NOT NULL, PRIMARY KEY (id))。
    • 必需参数为 query
  • query_school_websites:查询芝加哥公立学校网站数据库,获取与回答指定问题相关的上下文。
    • 必需参数为 question,可选参数为 school_name。

配置

从 [cps-childcare] 项目(https://github.com/mdagost/cps-childcare)获取 SQLite 数据库和 LanceDB 向量数据库。

快速开始

安装
Claude Desktop

MacOS:~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows:%APPDATA%/Claude/claude_desktop_config.json

开发/未发布服务配置:

  "mcpServers": {
    "mcp-cps-data": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-cps-data",
        "run",
        "mcp-cps-data",
        "--sqlite-path",
        "/path/to/cps_crawler.db",
        "--lancedb-path",
        "/path/to/embeddings.lancedb"
      ]
    }
  }
调试

由于 MCP 服务通过 stdio 运行,调试可能很有挑战性。为了获得最佳调试 体验,我们强烈建议使用 MCP Inspector。

你可以通过 npm 使用以下命令启动 MCP Inspector:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-cps-data run mcp-cps-data --sqlite-path /path/to/cps_crawler.db --lancedb-path /path/to/embeddings.lancedb

启动后,Inspector 会显示一个 URL,你可以在浏览器中访问该 URL 开始调试。

评论

支持 Markdown

第一次接触 MCP?

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

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