使用说明
VectorForge MCP服务器
用于VectorForge API的模型上下文协议(MCP)服务器,为LangChain、n8n和代理框架提供插件工具。
安装
git clone https://github.com/VectorForgeAI/mcp-server
cd mcp-server
npm install
npm run build
概述
VectorForge MCP服务器将VectorForge的信任和信心API作为MCP工具公开,从而实现:
- DIVT注册与验证 -数据的加密“出生证明”
- AI即时收据 -AI交互的不可变审计跟踪
- RAG快照 -知识库的版本控制
- 信心评分 -隐私保护和全语义评分
- 世界状态日志 -键入事件捕获以供将来分析
快速开始
配置
设置环境变量:
export VF_API_BASE_URL="https://api.vectorforge.ai"
export VF_API_KEY="vf_prod_YourApiKeyHere"
运行服务器
# DIVT Registry MCP
node dist/servers/divt-registry.js
# Prompt Receipts MCP
node dist/servers/prompt-receipts.js
可用的MCP服务器
1.DIVT注册表MCP
工具: vf.register, vf.verify
目的: 为任何对象颁发和验证加密的“出生证明”。
例子:
{
"tool": "vf.register",
"arguments": {
"object_id": "prompt:123",
"data_type": "prompt_receipt_v1",
"mode": "text",
"content": "What is the capital of France?"
}
}
答复:
{
"divt_id": "019abc12-3456-7890-abcd-ef0123456789",
"hash_b64": "OOBcM9ewZxJ/IX2MhW5VT8/wnJM...",
"ecdsa_sig_b64": "MIGIAkIB5ib9xCa0b9bGQ0d0qu...",
"ml_dsa_sig_b64": "tzOxKAUf84D/me6eKmz6e436pUq...",
"ledger_status": "pending",
"created_at": "2025-11-21T10:00:00Z"
}
2.MCP即时收据
工具: vf.prompt_receipt.create
目的: 获取每次AI呼叫的收据。
例子:
{
"tool": "vf.prompt_receipt.create",
"arguments": {
"prompt": "What is the capital of France?",
"response": "Paris",
"model": "gpt-4",
"metadata": {
"user_id": "user-123",
"workflow": "customer_support"
},
"also_register_divt": true
}
}
答复:
{
"wsl_id": "01J6ABC123...",
"divt_id": "019abc12-3456..."
}
3.RAG快照MCP
工具: vf.rag_snapshot.create
目的: 及时冻结你的知识库。
状态: 即将推出
4.世界状态记录仪MCP
工具: vf.worldstate.create
目的: 通用世界状态事件记录器。
状态: 即将推出
5.信心评分MCP
工具: vf.score.privacy, vf.score.full
目的: 在LLM答案中添加置信度。
状态: 即将推出
集成示例
LangChain
import { MCPTool } from '@langchain/community/tools/mcp';
const divtTool = new MCPTool({
serverCommand: 'node',
serverArgs: ['mcp/dist/servers/divt-registry.js'],
toolName: 'vf.register',
});
const result = await divtTool.call({
object_id: 'doc-123',
data_type: 'prompt_receipt_v1',
mode: 'text',
content: 'Hello, World!',
});
n8n
- 安装MCP插件
- 添加VectorForge MCP服务器
- 使用“呼叫MCP工具”节点
- 选择工具(例如。,
vf.register) - 提供论据
直接MCP客户端
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
const transport = new StdioClientTransport({
command: 'node',
args: ['mcp/dist/servers/divt-registry.js'],
});
const client = new Client(
{ name: 'my-app', version: '1.0.0' },
{ capabilities: {} }
);
await client.connect(transport);
const result = await client.callTool('vf.register', {
object_id: 'test-123',
data_type: 'prompt_receipt_v1',
mode: 'text',
content: 'Hello, World!',
});
发展
项目结构
mcp/
├── package.json
├── tsconfig.json
├── src/
│ ├── servers/
│ │ ├── divt-registry.ts ✅ Implemented
│ │ ├── prompt-receipts.ts ✅ Implemented
│ │ ├── rag-snapshots.ts 🚧 TODO
│ │ ├── worldstate.ts 🚧 TODO
│ │ └── scoring.ts 🚧 TODO
│ └── types/
│ └── mcp-schemas.ts ✅ Implemented
├── README.md
├── MCP_IMPLEMENTATION_GUIDE.md 📖 Full specs
└── IMPLEMENTATION_STATUS.md 📊 Progress tracker
建筑
npm run build
测试
# Test DIVT Registry
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node dist/servers/divt-registry.js
文档
- 实施指南 -完整的工具规格
- 实施状态 -进度跟踪器
- VectorForge API文档 -API参考
- 节点SDK -SDK文档
Claude桌面集成
添加到您的Claude Desktop配置文件中:
窗户: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"vectorforge-divt": {
"command": "node",
"args": ["/path/to/mcp-server/dist/servers/divt-registry.js"],
"env": {
"VF_API_KEY": "vf_prod_YourApiKeyHere",
"VF_API_BASE_URL": "https://api.vectorforge.ai"
}
}
}
}
支持
- 问题: GitHub问题
- 网站: https://vectorforge.ai
许可证
麻省 理工© VectorForge 的