英国政府技术标准 MCP 服务器

一个提供访问102个精选英国政府技术标准的模型上下文协议（MCP）服务器，适用于AI助手。根据工作类型和项目阶段获取上下文感知建议，涵盖可访问性、API、安全、云策略等。

提供的内容

• 102个精选标准：精心挑选的英国政府技术标准URL
• 上下文感知建议：基于您的工作类型和项目阶段获取标准
• 混合搜索：结合精确关键词匹配与语义理解
• 多种访问方法：MCP协议、HTTP API 和命令行工具
• 实时更新：通过自动化刷新功能保持标准最新

快速开始

先决条件

• Node.js 18+
• npm（随Node.js一起提供）

安装

# 克隆仓库
git clone <repository-url>
cd uk-gov-tech-standards-mcp

# 安装依赖
npm install

# 构建项目
npm run build

# 使用精选标准设置数据库（需要2-3分钟）
npm run setup

使用

启动MCP服务器：

npm run serve

启动HTTP API服务器：

npm run serve:http
# API 可在 http://localhost:3001 访问

Docker部署

先决条件

• Docker 和 Docker Compose

使用Docker快速开始

# 克隆仓库
git clone <repository-url>
cd uk-gov-tech-standards-mcp

# 复制环境模板
cp docker.env.template .env

# 构建并启动服务
docker-compose up -d

# 检查状态
docker-compose ps

设置包括：

• MCP服务器：localhost:3000
• HTTP API：localhost:8080
• ChromaDB：localhost:8000（向量数据库）

Docker服务

MCP服务器（默认）：

docker-compose up -d uk-gov-standards-mcp

HTTP服务器（替代）：

docker-compose --profile http-only up -d

两个服务器：

docker-compose up -d uk-gov-standards-mcp uk-gov-standards-http

数据持久化

Docker卷持久化数据在：

• ./data/ - SQLite数据库
• ./logs/ - 应用日志
• ./models/ - 机器学习模型缓存
• chromadb_data - 向量嵌入

Docker配置

环境变量（.env文件）：

NODE_ENV=production
LOG_LEVEL=info
DB_PATH=/app/data/standards.db
CHROMA_HOST=chromadb
CHROMA_PORT=8000

健康检查：

# 检查MCP服务器健康状况
curl http://localhost:3000/health

# 检查HTTP API健康状况
curl http://localhost:8
080/health

# 检查ChromaDB健康状况
curl http://localhost:8000/api/v1/heartbeat

日志：

# 查看所有日志
docker-compose logs -f

# 查看特定服务日志
docker-compose logs -f uk-gov-standards-mcp
docker-compose logs -f chromadb

MCP客户端配置

Claude Desktop

添加到您的claude_desktop_config.json：

{
  "mcpServers": {
    "uk-gov-standards": {
      "command": "node",
      "args": ["/绝对路径/to/uk-gov-tech-standards-mcp/dist/index.js"],
      "env": {
        "DATABASE_URL": "sqlite:/绝对路径/to/uk-gov-tech-standards-mcp/standards.db",
        "NODE_ENV": "production",
        "LOG_LEVEL": "info"
      }
    }
  }
}

其他MCP客户端

服务器实现了完整的MCP规范。使用这些连接详情：

• 命令：node
• 参数：["/路径/to/dist/index.js"]
• 工作目录：项目根目录
• 环境：设置DATABASE_URL为您的数据库路径

🛠 MCP工具

服务器提供了8个上下文感知工具：

核心搜索工具

search_uk_gov_standards

• 在所有102个精选标准中搜索
• 混合搜索：精确关键词 + 语义理解
• 参数：query（必需），category，organisation

get_standard_by_id

• 获取特定标准的详细信息
• 参数：standardId（必需）

list_categories

• 获取所有可用类别及其数量
• 不需要参数

get_recent_updates

• 获取最近更新的标准
• 参数：daysBack（默认：30）

上下文感知工具

get_applicable_standards

• 获取特定工作上下文的标准
• 参数：workType[]，serviceType[]，developmentPhase[]

get_mandatory_standards

• 获取所有强制/关键标准
• 不需要参数

get_standards_by_priority

• 按优先级过滤
• 参数：priority（关键，高，中，低）

get_category_hierarchy

• 获取分层类别结构
• 参数：categoryId（可选）

合规工具

check_compliance

• 生成服务合规检查清单
• 参数：serviceDescription（必需）

HTTP API

当运行npm run serve:http时，访问以下端点：

搜索与发现

GET /api/search?q=<query>&category=<category>&org=<organisation>
GET /api/standards/<id>
GET /api/categories
GET /api/recent?days=<days>

上下文感知端点

POST /api/applicable
{
  "workType": ["前端", "后端"],
  "serviceType": ["面向市民"],
  "developmentPhase": ["开发", "测试"]
}

GET /api/mandatory
GET /api/priority/<level>
GET /api/hierarchy?categoryId=<id>

POST /api/compliance
{
  "serviceDescription": "您的服务描述"
}

精选标准类别

102个标准分布在11个专注类别中：

类别	数量	使用时机
设计和构建政府服务	30	任何政府服务开发
标准	21	通用合规性和最佳实践
设计安全	14	安全导向开发
可访问性	10	前端/UI开发
开源和开放标准	8	技术选择和架构
APIs	5	REST, SOAP, GraphQL开发
遗留技术	3	现代化项目
原生或混合应用	3	移动应用开发
云策略	2	云采用和迁移
数据	2	数据管理和GDPR
应用程序开发	1	通用开发指导

🔍 搜索能力

混合搜索系统

• 全文搜索（FTS）：快速精确/部分关键词匹配
• 语义搜索：理解意义和上下文（当可用时）
• 优雅降级：即使没有语义特性也能正常工作

上下文感知推荐

根据您的具体工作获取相关标准：

工作上下文	示例结果
前端 + 面向市民	可访问性标准，WCAG指南
后端 + APIs	API技术标准，安全指南
移动 + 原生应用	iOS/Android安全，应用商店指南
云 + 数据	GDPR合规，云优先政策

高级用法

自定义数据库路径

DATABASE_URL="sqlite:/自定义路径/standards.db" npm run setup

更新现有数据库

npm run update  # 刷新标准内容

开发模式

npm run dev     # 使用热重载运行
npm test        # 运行测试套件

日志配置

设置LOG_LEVEL环境变量：

• error：仅错误
• warn：警告和错误
• info：一般信息（默认）
• debug：详细调试

系统架构

专注方法

该系统采用精选方法而非广泛发现：

• ✅ 102个特定URL来自精心挑选的英国政府标准
• ✅ 11个专注类别具有明确适用性上下文
• ✅ 上下文感知推荐基于您的工作上下文
• ✅ 基于优先级的过滤（关键，高，中，低）
• ✅ 强制与可选明确区分
• ✅ 更快、可预测的设置（2-3分钟 vs 10+分钟）

技术栈

• 数据库：SQLite带FTS5全文搜索
• 搜索：混合FTS + 语义相似度（可选）
• 网络抓取：Puppeteer带智能内容处理
• API：Express.js HTTP服务器
• MCP：完整的模型上下文协议实现
• 嵌入式：Transformers.js带本地模型（可选）

数据来源

所有102个标准均来自官方英国政府网站：

• GDS服务手册：设计和可访问性标准
• NCSC指南：安全和网络安全标准
• 内阁办公室：数字服务和开放标准
• Gov.UK指南：APIs、云和技术标准
• ICO资源：数据保护和GDPR合规

故障排除

常见问题

数据库损坏：

rm -f standards.db*
npm run setup

端口已被占用：

# 在src/http-server.ts中更改端口或终止现有进程
pkill -f "http-server"

语义搜索不可用：

• 这是正常的 - 系统会优雅地回退到FTS搜索
• 完整的语义搜索需要额外的向量数据库设置

获取帮助

1. 检查logs/server.log中的日志
2. 验证Node.js版本：node --version（需要18+）
3. 确保数据库存在：ls -la standards.db
4. 测试基本功能：npm test

许可证

MIT许可证 - 详情参见LICENSE文件。

贡献

1. 分叉仓库
2. 创建功能分支
3. 进行更改
4. 如适用，添加测试
5. 提交拉取请求

更新

系统自动跟踪标准的更新时间。定期运行npm run update以刷新内容。

---

为AI助手提供准确、最新的英国政府技术指导而构建。