开放数据 MCP 协议服务器

项目介绍

为了将数百万公开可用的数据集引入所有大语言模型 (LLM) 应用程序，我们启动了开放数据 MCP 协议服务器项目。这个项目的目标是通过 MCP 协议为 LLM 应用提供开放数据的访问，使这些数据能够被各种 LLM 工具和平台使用。

使用指南

数据集访问

通过我们的 MCP 服务器，您可以搜索和查询公开可用的数据集。以下是几种主要的数据集类型及其适用场景：

1. 静态数据集：

   • 如果数据集内容相对固定且更新频率低，建议将其作为资源提供。
   • 示例：小型表格数据、文档库等。

2. 动态数据集：

   • 对于需要实时查询或计算的数据集，应实现为工具接口。
   • 示例：数据库查询、API 调用结果等。

实现指南

• 选择工具还是资源：

  • 如果您的数据集需要基于参数的过滤、复杂的转换或需要动态查询，请实现为工具接口。
  • 如果数据集内容静态且适合内存加载，建议作为资源提供。

• 测试要求：

  • 添加全面的测试以确保功能正常。
  • 验证错误处理机制和性能表现。

贡献指南

我们欢迎社区贡献，共同扩展这个项目。以下是我们接受的贡献类型：

代码贡献

• 提交新的 MCP 服务器实现（基于工具或资源）。
• 修复现有代码中的问题。
• 增强功能模块。

文档贡献

• 编写详细的文档说明。
• 整理和补充使用指南。
• 优化示例内容。

项目架构

open-data-mcp
├── src/
│   ├── mcp/
│   │   └── server.py      # MCP 协议服务器实现
│   └── providers/        # 各数据集提供者的实现目录
│       ├── __init__.py
│       ├── tool_provider.py    # 工具接口示例
│       └── resource_provider.py  # 资源提供者示例
├── tests/
│   ├── test_server.py     # 服务器功能测试
│   └── test_providers/    # 各数据集提供者的测试用例
└── README.md               # 项目说明文件

开发规范

代码风格

• 遵循 PEP8 编码规范。
• 使用 Black 或 Ruff 进行格式化。

版本控制

• 每次提交都需要包含详细的提交信息。
• 定期进行代码审查。

项目现状

• 已实现功能：

  • 初始服务器架构
  • 基础数据提供者接口
  • 测试框架建立
  • 自动化发布流程

• 待开发功能：

  • 支持更多数据源类型
  • 客户端工具开发
  • 性能优化

讨论社区

欢迎加入我们的 Discord 社区，参与项目讨论和贡献：

Discord 邀请链接

限制说明

• 所有通过 MCP 服务器提供的数据必须是公开可用的。
• 必须遵守原始数据提供者的许可协议。
• 商业应用需遵循项目 MIT 许可证要求。

参考资料

• 致谢于 Anthropic 的开源 MCP 协议 释放的利好。

授权协议

本项目采用 MIT 许可证，具体条款请参阅 LICENSE 文件。