mcp-mtender-server

🚀 MTender 数据服务器使用说明

MTender 数据服务器是一款 MCP 系统数据读取器，可提供 Moldova 公共采购和合同信息。借助它，用户能够通过 URI 或工具接口访问结构化的 OCDS（开放合同数据标准）数据。

🚀 快速开始

要使用 MTender 数据服务器，请按照以下步骤进行：

1. 下载并安装 Node.js 和 npm。
2. 克隆此 GitHub 仓库：https://github.com/yoda-digital/mcp-mtender-server
3. 在项目根目录中运行命令 npm install 安装依赖项。
4. 在终端中运行 npm start 启动服务器，默认端口为 3000。

✨ 主要特性

资源 URI

• mtender://latest-tenders：列出最新的招标公告
• mtender://tender/{ocid}：通过 OCID 获取招标详细信息
• mtender://budget/{ocid}：通过 OCID 获取预算信息
• mtender://funding/{ocid}：通过 OCID 获取资金来源信息

工具接口

服务器提供了以下工具接口：

1. search_tenders：搜索招标公告
   • 支持分页、按日期范围筛选等高级功能。
2. get_tender：获取单个招标的详细信息
   • 可选格式输出：完整数据或简洁摘要。
3. get_budget：查询预算详情
4. get_funding_source：查看资金来源信息
5. analyze_tender：分析招标文档指定部分（如计划、投标、奖项等）
6. fetch_tender_document：下载并解析指定的招标文件 URL

📚 详细文档

工具参数说明

search_tenders

• offset（可选）：分页偏移量（ISO日期字符串）
• limit（可选）：结果最大数量
• dateFrom（可选）：起始日期（ISO日期字符串）
• dateTo（可选）：结束日期（ISO日期字符串）

get_tender

• ocid（必填）：OCID 值
• format（可选）：输出格式，支持 "full" 和 "summary"

get_budget

• ocid（必填）：OCID 值
• format（可选）：输出格式，支持 "full" 和 "summary"

get_funding_source

• ocid（必填）：OCID 值
• format（可选）：输出格式，支持 "full" 和 "summary"

analyze_tender

• ocid（必填）：OCID 值
• sections（可选）：指定分析的部分，如 "plan"、"tender"、"award"

fetch_tender_document

• url（必填）：完整的招标文件 URL
• 返回：解析后的文档内容或错误信息

示例查询

💻 使用示例

基础用法

# 获取最新招标公告
curl http://localhost:3000/mtender/latest-tenders

高级用法

# 搜索特定日期范围的招标
curl "http://localhost:3000/mtender/search_tenders?dateFrom=2023-01-01&dateTo=2023-12-31"

日志记录

服务器默认启用日志记录功能，所有请求和响应都会记录到 logs/ 目录下的文件中。日志格式为标准 JSON 格式，便于后续分析。

已知限制

1. 数据延迟：MTender 数据会存在一定的更新延迟（通常为 30 分钟）。
2. 最大并发数：服务器默认支持 50 个并发请求，超出后将排队处理。
3. 文件大小限制：单个招标文档的最大解析大小为 10MB。

🔧 技术细节

API 参考

资源接口

最新招标公告

GET /mtender/latest-tenders

响应示例：

[
    {
        "ocid": "MD-234567",
        "title": "公共道路维修项目",
        "date": "2023-10-01"
    },
    ...
]

单个招标详情

GET /mtender/tender/{ocid}

响应示例：

{
    "ocid": "MD-234567",
    "title": "公共道路维修项目",
    "description": "修复 County Balti 的主要街道",
    "date": "2023-10-01"
}

工具接口

搜索招标

POST /mtender/search_tenders
{
    "query": {
        "offset": 0,
        "limit": 10,
        "dateFrom": "2023-01-01",
        "dateTo": "2023-12-31"
    }
}

📄 许可证

版权声明

MTender 数据服务器的版权归 Yoda Digital 所有，源代码遵循 MIT 协议。

使用条款

仅允许用于个人和非商业用途。禁止在未授权的情况下进行二次开发或商用。

贡献指南

欢迎通过 GitHub 提交问题和拉取请求：https://github.com/yoda-digital/mcp-mtender-server

如需进一步支持，请联系 support@yodalabs.md。