https://claude.ai/chat/4dea4e6a-4f62-44b0-8a96-f87167a17fef https://claude.ai/public/artifacts/8f2db72a-f062-4d0c-b64c-e7f4018910d6

cloudflared tunnel --url http://localhost:3001

• 电子邮件: test@example.com

• 密码: password123

PocketBase 任务 MCP 服务器

一个与 PocketBase 集成以管理任务和项目的模型上下文协议 (MCP) 服务器。该服务器允许 AI 模型（如 Claude）创建任务、按状态筛选列出任务以及浏览项目。

现已通过 HTTP 运行 - 易于本地测试并可随时部署！

功能

• HTTP 传输: 基于 URL 的简单访问，无需复杂的配置

• 工具链: 通过先获取 ID 自动将任务链接到项目

• 项目管理: 列出 projects 集合中的所有项目

• 任务管理: 在 task 集合中创建具有强制项目关联的任务

• 状态筛选: 列出任务并按“待处理”或“已完成”状态进行筛选

• 环境驱动: 通过 .env 文件安全管理 PocketBase 身份验证

• 轻松测试: 简单的健康检查端点和 MCP Inspector 支持

⚡ 快速开始

# 1. Install dependencies
npm install

# 2. Create .env file
echo "PB_AUTH_TOKEN=your_super_admin_token_here" > .env

# 3. Build the project
npm run build

# 4. Start the server
node dist/index.js

您的服务器现已在 http://localhost:3000 运行！

测试它：在浏览器中打开 http://localhost:3000/health。

🚀 入门指南

1. 先决条件

• Node.js (v18+)

• PocketBase 在本地 http://127.0.0.1:8090 运行

• 一个 PocketBase 超级管理员令牌。

2. 安装

npm install

3. 配置

在项目根目录创建一个 .env 文件：

PB_AUTH_TOKEN=your_super_admin_token_here

🛠️ 开发与调试

构建项目

将 TypeScript 代码编译为 JavaScript：

npm run build

启动 HTTP 服务器

在本地运行服务器：

node dist/index.js

服务器将在 http://localhost:3000（或您在 .env 文件中指定的端口）启动。

您应该看到类似以下的输出：

MCP server running on http://localhost:3000
Health check: http://localhost:3000/health
MCP endpoint: http://localhost:3000/mcp

测试服务器

在浏览器中访问健康检查端点：

http://localhost:3000/health

您应该看到：

{"status":"ok","message":"PMS MCP Server is running"}

可选端口配置

添加到您的 .env 文件以更改端口：

PORT=3000
PB_AUTH_TOKEN=your_super_admin_token_here

📖 可用工具

• list_projects: 获取所有项目及其 ID。

• create_task: 创建新任务（需要 task_title、eta、status 和 project_id）。

• list_tasks: 列出所有任务，并可选择按状态筛选。

🧪 测试工具

您可以使用 MCP Inspector 或通过 http://localhost:3000/mcp 的 HTTP 端点连接来测试 MCP 服务器。

使用 MCP Inspector

npx @modelcontextprotocol/inspector

然后连接到：http://localhost:3000/mcp

🌐 为什么选择 HTTP 而非 Stdio？

优势：

• 无需配置文件: 无需编辑 claude_desktop_config.json 或其他复杂配置

• 易于测试: 通过浏览器或 Postman 等工具进行简单的 URL 访问

• 支持远程: 可部署到服务器并从任何地方访问

• 多客户端: 多个应用程序可以同时连接

• 更好的调试: 使用标准 HTTP 工具轻松监控请求和响应

从 MCP 客户端连接：

使用兼容 MCP 的客户端时，请连接到：

http://localhost:3000/mcp

📝 依赖项

• @modelcontextprotocol/sdk: 核心 MCP 功能

• pocketbase: PocketBase JS SDK

• express: HTTP 服务器框架

• cors: 跨域资源共享中间件

• zod: 模式验证

• dotenv: 环境变量管理