MCP事实检查MCP服务器
MCP服务器,用于根据官方信息验证代码或内容 模型上下文协议(MCP) 规范,以确保技术准确性并防止错误信息的传播。
📦 在MCP注册表中查看 -可在MCP官方注册表中找到
📋 查看项目路线图 -查看计划功能和开发进度
🏗️ 设计文件 -技术设计和实施细节
概述
MCP事实检查MCP服务器通过将内容与官方规范进行比较,帮助确保在编码或编写MCP时的技术准确性。它使用:
- 语义搜索 使用OpenAI嵌入来查找相关的规范部分
- 人工智能驱动的验证 检测不准确之处并提出更正建议
- 复合索赔分解 使用多个断言验证复杂语句
- 多种规格版本 支持(草案,2025年6月18日,2025年3月26日,2024年11月5日)
特性
MCP工具暴露
check_mcp_claim-MCP相关内容的全面验证
- 验证多索赔内容(文档、教程、要点) - 自动分解化合物声明(例如“X和Y”)以进行准确验证 - 提供分步验证工作流程 - 识别缺失的最佳实践和情态动词问题 - 返回带有置信度评分的更正内容
check_mcp_quick_fact-对单一MCP索赔进行快速事实核查
- 验证单句或快速问题 - 返回简洁✓/✗ 有解释的判决 - 使用激进的搜索策略来提高准确性 - 非常适合“MCP支持X吗?”问题
search_spec-使用语义相似性搜索MCP规范
- 返回最相关的规范部分 - 支持所有规范版本
list_spec_versions-列出可用的MCP规范版本
- 显示版本日期和描述 - 指示当前版本
MCP提示可用
migrate-mcp-content-指导MCP规范版本之间的内容迁移
- 首先根据源代码规范验证内容 - 识别规范版本之间的变化 - 提供逐步迁移指导 - 适用于任何类型的MCP相关内容 - 在进行更正或建议时,保留原始的语调、风格和声音
参数:
- current_version (必填):源MCP规范版本(例如“2024-11-05”、“2025-06-18”) - target_version (必填):迁移到的目标MCP规范版本(例如“草稿”) - update_scope (可选):确定迁移的积极程度 - critical_only:仅修复关键的不准确和破坏性更改(最小更改) - enhancement_focused:解决问题并提高清晰度,与最佳实践保持一致 - comprehensive:完成审查,包括所有改进和提高清晰度 - 违约: comprehensive
安装
MCP事实检查服务器可通过 模型上下文协议注册表.直接从MCP客户端安装:
对于Claude Desktop和其他MCP客户:
- 在客户的服务器市场中搜索“mcp factcheck”
- 单击安装
- 提示时提供您的OpenAI API密钥
就是这样!服务器将自动配置并准备使用。
对于开发者: 如果您需要从源代码构建或为项目做出贡献,请参阅 安装.md 获取开发设置说明。
可观测性
《干旱凤凰》的视觉追踪
要获得一个漂亮的、以人工智能为中心的轨迹可视化UI,请设置Arize Phoenix:
- 安装并启动Phoenix:
# Install Phoenix
pipx install arize-phoenix
# Start Phoenix server
phoenix serve- 更新主机配置以向Phoenix发送跟踪:
{
"mcpServers": {
"mcp-factcheck": {
"command": "/path/to/bin/mcp-factcheck-server",
"args": [
"--data-dir",
"/path/to/data/embeddings",
"--telemetry",
"--otlp-endpoint",
"http://localhost:6006"
],
"env": {
"OPENAI_API_KEY": "your-api-key"
}
}
}
}- 在以下位置查看痕迹: http://localhost:6006
你将在凤凰城看到什么:
- 专为LLM应用程序设计的漂亮的AI界面
- 完整的验证流程时间线,具有清晰的视觉层次结构
- 嵌入式生成性能和OpenAI API调用跟踪
- 具有相似性分数的矢量搜索可视化
- 每块验证置信度和质量指标
- OpenAI API使用成本跟踪(或用于嵌入输入内容/代码的llm)
- 专注于AI工作流程的简洁直观的导航
Phoenix专为AI/ML可观察性而设计,提供了比传统跟踪工具更用户友好的体验。
发展
建筑
# Build all components
go build -o bin/mfc ./cmd/server
go build -o bin/specloader ./utils/cmd
# Run tests
go test ./...更新规格
该项目包括所有版本的预提取MCP规范和嵌入。要检查规范草案上次更新的时间,请参阅 data/SPEC_METADATA.json:
# View draft update information
cat data/SPEC_METADATA.json | jq '.specs.draft'要更新规范草案,请执行以下操作:
./bin/specloader spec --version draft
./bin/specloader embed --version draft
./bin/specloader embed --version draft-fine要添加新的规范版本,请执行以下操作:
./bin/specloader spec --version 2025-12-15
./bin/specloader embed --version 2025-12-15
./bin/specloader embed --version 2025-12-15-fine所有规范提取日期和源代码提交都会在中自动跟踪 data/SPEC_METADATA.json.
测试工具
使用附带的测试客户端测试服务器:
# Build test client
go build -o bin/factcheck-curl ./cmd/factcheck-curl
# Test tools
./bin/factcheck-curl --cmd ./bin/mfc --data-dir ./data/embeddings tools/list
./bin/factcheck-curl --cmd ./bin/mfc --data-dir ./data/embeddings tools/call validate_content '{"content":"MCP is a protocol"}'
# Test prompts
./bin/factcheck-curl --cmd ./bin/mfc --data-dir ./data/embeddings prompts/list
# Get migration prompt with minimal parameters
./bin/factcheck-curl --cmd ./bin/mfc --data-dir ./data/embeddings prompts/get migrate-mcp-content '{"current_version":"2024-11-05","target_version":"draft"}'
# Get migration prompt with all parameters
./bin/factcheck-curl --cmd ./bin/mfc --data-dir ./data/embeddings prompts/get migrate-mcp-content '{
"current_version": "2024-11-05",
"target_version": "2025-06-18",
"update_scope": "critical_only"
}'建筑
看 设计.md 查看完整的架构文档。
环境变量
OPENAI_API_KEY-嵌入生成和内容验证所需GITHUB_TOKEN-可选,用于提取规范时更高的GitHub API速率限制
许可证
MIT许可证。看 许可证 了解详情。
