Tacitbase MCP 服务器

这是一个 Tacitbase 的机器理解协议 (MCP) 服务器，它使用 Tacitbase 的原生搜索和 Typesense 提供增强的搜索功能，从而提供高级搜索能力。

项目结构

该项目遵循清晰、模块化的架构：

.
├── models/      # 数据结构和类型
├── services/    # 业务逻辑和外部服务交互
├── handlers/    # 请求处理程序和路由逻辑
├── tools/       # 工具注册和配置
├── main.go      # 应用程序入口点
└── README.md    # 项目文档

包

• models: 包含应用程序中使用的所有数据结构和类型
• services: 实现业务逻辑和外部服务交互
• handlers: 包含处理传入请求的请求处理程序
• tools: 注册可用于搜索候选人的工具

功能

• 具有过滤和排序功能的基本关键字搜索
• 用于基于相似性的匹配的向量搜索
• 具有自然语言理解的语义搜索
• 在需要时回退到 Tacitbase 的原生搜索
• 用于搜索候选人的工具注册

搜索工具

1. 基本搜索 (search_candidates)

• 基于关键字的搜索，具有拼写容错能力
• 支持特定字段的搜索
• 过滤和排序功能
• 分组功能
• 精确匹配选项

2. 向量搜索 (vector_search_candidates)

• 使用向量嵌入的相似性搜索
• 非常适合查找具有相似配置文件的候选人
• 支持将向量与过滤器相结合的混合搜索

3. 语义搜索 (semantic_search_candidates)

• 自然语言理解
• 自动嵌入生成
• 支持多种嵌入模型（OpenAI、SBERT、E5）
• 将语义理解与过滤器相结合的混合搜索

配置

环境变量

• TACITBASE_AUTH_TOKEN: Tacitbase API 的身份验证令牌
• TYPESENSE_API_KEY: Typesense 的 API 密钥
• TYPESENSE_HOST: Typesense 主机（默认：localhost）
• TYPESENSE_PORT: Typesense 端口（默认：8108）
• TYPESENSE_PROTOCOL: Typesense 协议（默认：http）

安装

1. 安装依赖项：

go mod download

2. 构建服务器：

go build -o tb-mcp-server

3. 运行服务器：

./tb-mcp-server

使用示例

基本搜索

{
  "query": "golang developer",
  "search_fields": "skills,latest_experience",
  "filter_fields": "location:San Francisco",
  "sort_by": "latest_experience:desc",
  "page": 1,
  "per_page": 20
}

向量搜索

{
  "vector_query": "[0.1, 0.2, ..., 0.512]",
  "filter_fields": "years_of_experience:>5",
  "page": 1,
  "per_page": 20
}

语义搜索

{
  "query": "experienced team lead with cloud architecture background",
  "embedding_model": "openai",
  "filter_fields": "years_of_experience:>8",
  "page": 1,
  "per_page": 20
}

开发

要修改或扩展服务器：

1. 编辑 main.go 以添加新工具或修改现有工具
2. 运行测试（如果有）
3. 构建并测试服务器