模型上下文协议服务器

VectorForge MCP服务器为VectorForge API提供模型上下文协议工具,支持数据验证、AI交互审计和知识库版本控制等功能,适用于AI开发框架集成。

  • by VectorForgeAI
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 VectorForgeAI/mcp-server

使用说明

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

  1. 安装MCP插件
  2. 添加VectorForge MCP服务器
  3. 使用“呼叫MCP工具”节点
  4. 选择工具(例如。, vf.register)
  5. 提供论据

直接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

文档


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"
      }
    }
  }
}

支持


许可证

麻省 理工© VectorForge 的