SuperAPI AI 工具集

mcp-server-development

智能体与模型

查看项目

更新于 10-15 22:11

技能介绍

用途:指导 Riksdagsmonitor 平台开发与配置 Model Context Protocol(MCP)服务器,使 AI 工具能与 GitHub Copilot 及其他兼容 MCP 的客户端集成。适用于为政治数据访问创建新 MCP 工具、配置 .github/copilot-mcp-config.json、设计结构化数据检索的工具 schema、实现 stdio/SSE/HTTP 传输,以及将 GitHub MCP 工具接入 CI/CD。不适用于标准 REST API 开发或 UI 组件开发。

主要能力:MCP 架构由客户端(Copilot/IDE)经 JSON-RPC 2.0(stdio/SSE)调用 MCP 服务器工具,再访问数据源(如 Riksdag API)。工具定义包含 name、description 与 inputSchema(JSON Schema,含 properties 与 required)。示例工具包括 get_politician_profile(按 personId 查询议员资料与投票记录)和 search_riksdag_documents(按关键词、文档类型 motion/proposition/betankande 与日期范围检索)。

配置与用法:Copilot MCP 配置示例中,mcpServers 下定义 cia-political-data,type 为 stdio,command 为 node,args 为 ["dist/mcp-server.js"],env 使用 ${workspaceFolder}/data。规则:不得在配置中内嵌密钥,改用环境引用;工具职责单一;处理前用 JSON Schema 校验输入;返回结构化数据;错误响应包含细节。错误处理模式为 try/catch,成功返回 content 文本,失败返回 isError: true。

GitHub MCP 集成:用于仓库管理、Issue 跟踪、PR 工作流、Actions 触发与状态检查、安全扫描。建议使用具体查询、处理分页、缓存响应、对速率限制实现指数退避。

安全与限制:需输入校验、基于令牌认证、最小权限授权、审计日志(不记录敏感数据)、远程服务器使用加密传输。ISMS 对齐 ISO 27001 A.8.9、NIST CSF PR.DS-2、CIS Control 16。具体平台部署细节与完整实现步骤暂未提供。