AIID MCP服务器
模型上下文协议（MCP）服务器，通过VS代码提供对AI事件数据库GraphQL API的访问。
概述
该服务器实现了模型上下文协议，允许GitHub Copilot等AI助手与AI事件数据库（AIID）进行交互。它支持查询事件和报告，并支持过滤、分页、排序和输出格式选择。
特性
- 事故数据访问：使用过滤和排序选项查询AI事件
- 报告数据访问：通过可定制的字段选择访问与事件链接的报告
- 多种输出格式：返回JSON或CSV格式的数据
- 分页支持：控制大型数据集的结果大小和偏移量
安装
- 从npm安装包：
npm install -g aiid-mcp- 将MCP服务器配置添加到您的VS Code settings.json中：
"mcp": {
"servers": {
"aiid-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"aiid-mcp"
]
}
}
}- 重新启动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服务器：
- 克隆此存储库：
git clone https://github.com/yourusername/aiid-mcp.git
cd aiid-mcp- 安装依赖项：
npm install- 构建项目：
npm run build- 配置VS Code以使用您的本地开发版本：
"mcp": {
"servers": {
"aiid-mcp": {
"type": "stdio",
"command": "node",
"args": [
"/absolute/path/to/aiid-mcp/dist/index.js"
]
}
}
}替换 /absolute/path/to/aiid-mcp 了解项目的实际路径。
- 重新加载VS代码以应用更改。
有关开发指南，请参阅 代理商.md 有关以下内容的详细说明：
- 了解MCP架构
- 对MCP工具实施进行更改
- 构建TypeScript代码
- 测试MCP功能
- 需要避免的常见陷阱
关键开发工作流程
- 进行代码更改
- 构建TypeScript代码：
npm run build - 重新加载VS代码以应用更改
- 测试功能
GraphQL模式生成
此项目使用GraphQL代码生成器从AIID GraphQL模式创建TypeScript类型：
npm run codegen许可证
国际协调委员会
贡献
欢迎投稿！请随时提交拉取请求。