AIID MCP服务器

AIID MCP服务器

模型上下文协议（MCP）服务器，通过VS代码提供对AI事件数据库GraphQL API的访问。

概述

该服务器实现了模型上下文协议，允许GitHub Copilot等AI助手与AI事件数据库（AIID）进行交互。它支持查询事件和报告，并支持过滤、分页、排序和输出格式选择。

特性

• 事故数据访问：使用过滤和排序选项查询AI事件
• 报告数据访问：通过可定制的字段选择访问与事件链接的报告
• 多种输出格式：返回JSON或CSV格式的数据
• 分页支持：控制大型数据集的结果大小和偏移量

安装

1. 从npm安装包：

   复制

   npm install -g aiid-mcp
   

2. 将MCP服务器配置添加到您的VS Code settings.json中：

   复制

   "mcp": {
       "servers": {
           "aiid-mcp": {
               "type": "stdio",
               "command": "npx",
               "args": [
                   "aiid-mcp"
               ]
           }
       }
   }
   

3. 重新启动VS Code以激活MCP服务器。

用法

配置后，您可以使用VS Code中的MCP工具：

获取事件

从AI事件数据库查询事件：

// Example: Get incidents in CSV format
{
  "fields": ["incident_id", "title", "date", "description"],
  "format": "csv",
  "pagination": {"limit": 5}
}

获取报告

从AI事件数据库查询报告：

// Example: Get reports for a specific source domain
{
  "fields": ["report_number", "title", "source_domain", "date_published"],
  "filter": {
    "source_domain": {"EQ": "nytimes.com"}
  },
  "format": "json"
}

发展

如果您想开发或修改此MCP服务器：

1. 克隆此存储库：

   复制

   git clone https://github.com/yourusername/aiid-mcp.git
   cd aiid-mcp
   

2. 安装依赖项：

   复制

   npm install
   

3. 构建项目：

   复制

   npm run build
   

4. 配置VS Code以使用您的本地开发版本：

   复制

   "mcp": {
       "servers": {
           "aiid-mcp": {
               "type": "stdio",
               "command": "node",
               "args": [
                   "/absolute/path/to/aiid-mcp/dist/index.js"
               ]
           }
       }
   }
   

   替换 /absolute/path/to/aiid-mcp 了解项目的实际路径。

5. 重新加载VS代码以应用更改。

有关开发指南，请参阅 代理商.md 有关以下内容的详细说明：

• 了解MCP架构
• 对MCP工具实施进行更改
• 构建TypeScript代码
• 测试MCP功能
• 需要避免的常见陷阱

关键开发工作流程

1. 进行代码更改
2. 构建TypeScript代码： npm run build
3. 重新加载VS代码以应用更改
4. 测试功能

GraphQL模式生成

此项目使用GraphQL代码生成器从AIID GraphQL模式创建TypeScript类型：

npm run codegen

许可证

国际协调委员会

贡献

欢迎投稿！请随时提交拉取请求。

相关资源

• 人工智能事件数据库
• 模型上下文协议文档