项目简介: Pathwise MCP 服务器是 Pathwise 求职追踪系统的一个核心组件，专门为大型语言模型（LLM）客户端和自动化工具设计。它通过 Model Context Protocol (MCP) 标准，提供对用户求职申请数据（如职位详情、状态、备注、薪资等）的程序化访问。

主要功能点:

数据访问： 允许外部系统查询用户的求职申请、状态历史和备注。
工具集成： 以标准化的方式封装了数据访问逻辑，作为可调用的"工具"提供给LLM客户端。
安全认证： 支持通过 API 密钥进行认证，确保数据访问安全。
会话管理： 维护客户端与服务器之间的连接状态和上下文。

安装步骤:

克隆仓库:

git clone https://github.com/Piszmog/pathwise.git
cd pathwise

安装Go模块依赖:
```
go mod download
```

生成代码并构建前端资源 (如果需要，但MCP服务器通常不需要所有前端资源):

go tool templ generate -path ./ui/components
go tool go-tw -i ./ui/styles/input.css -o ./ui/dist/assets/css/[email protected]
go tool sqlc generate

构建MCP服务器可执行文件:

go build -o ./tmp/mcp ./cmd/mcp

运行MCP服务器:
```
./tmp/mcp
```
服务器将默认在 'http://localhost:8081' 监听。

服务器配置 (MCP客户端需要): MCP客户端需要通过JSON-RPC协议连接到Pathwise MCP服务器。以下是配置MCP客户端时可能需要的关键信息和示例配置结构。请注意，MCP客户端应根据实际部署情况配置服务器地址和端口。API 密钥需要在 Pathwise Web 应用程序的设置中生成。

{
  "server_name": "Pathwise MCP Server",
  "command": "./tmp/mcp", 
  "args": [],             
  "env": {
    "DB_PRIMARY_URL": "your_database_primary_url_here", 
    "DB_TOKEN_READONLY": "your_database_readonly_token_here", 
    "PORT": "8081" 
  },
  "authentication": {
    "api_key": "YOUR_GENERATED_API_KEY" 
  },
  "url": "http://localhost:8081" 
}

参数注释:

'server_name': MCP服务器的标识名称。
'command': 启动MCP服务器的命令。在本地运行，通常是您构建的可执行文件路径，例如 './tmp/mcp'。
'args': 传递给MCP服务器的命令行参数列表。Pathwise MCP服务器目前主要依赖环境变量配置，因此通常为空。
'env': 启动MCP服务器时需要设置的环境变量。
- 'DB_PRIMARY_URL': 如果使用嵌入式或远程数据库，可能需要配置数据库的同步URL。
- 'DB_TOKEN_READONLY': 用于数据库连接的只读访问令牌。
- 'PORT': MCP服务器监听的端口，默认是 '8081'。
'authentication': 包含客户端认证MCP服务器所需的信息。
- 'api_key': MCP客户端在调用工具时需要在请求头中包含此API密钥进行认证。此密钥需在Pathwise Web应用的用户设置页面中生成。
'url': MCP服务器的完整访问URL，包括协议、主机和端口。MCP客户端将连接到此地址。

基本使用方法:

启动 MCP 服务器: 按照“安装步骤”中的说明运行 MCP 服务器可执行文件。
获取 API 密钥: 访问 Pathwise Web 应用程序 ('http://localhost:8080')，登录后进入设置页面，生成您的 MCP API 密钥。
配置 MCP 客户端: 使用上述“服务器配置”示例，将 'command'、'url' 和 'api_key' 替换为您的实际值。
调用 MCP 工具: 您的 MCP 客户端现在可以通过 JSON-RPC 协议调用 Pathwise MCP 服务器上注册的工具，例如 'job_applications'、'job_applications_status_history' 或 'job_applications_notes'，以获取您的求职数据。

关键词

信息