返回 MCP 目录
public公开dns本地运行

BrunoSSantana_poc-mcp-server

一个概念验证的MCP服务器实现,提供访问和操作Loomers、表单、表单响应及项目数据的工具。

article

README

🚀 POC MCP 服务器

POC MCP 服务器是 Model Context Protocol (MCP) 服务器的一个概念验证实现。它提供了一系列工具,用于访问和操作与 Loomer、表格单、表单响应和项目相关的数据,为相关数据处理提供了便利。

🚀 快速开始

POC MCP 服务器能满足你对 Loomer、表格单、表单响应和项目相关数据的访问与操作需求。下面为你介绍启动该服务器的步骤。

✨ 主要特性

  • 可获取 Loomers 及其在特定区域内的信息。
  • 能够获取 Forms 和 Form Responses。
  • 支持获取 Projects。
  • 所有列表操作均支持分页功能。
  • 具备过滤和排序功能,方便数据筛选和整理。

📦 安装指南

需求

  • Node.js 18 或更高版本。
  • pnpm 10 或更高版本。

安装命令

pnpm install

💻 使用示例

开发环境

要启动开发服务器,可使用以下命令:

pnpm dev

构建项目

使用以下命令构建项目:

pnpm build

运行项目

运行已构建的项目,使用命令:

pnpm start

测试项目

运行测试,使用命令:

pnpm test

代码检查

运行代码检查工具,使用命令:

pnpm lint

📚 详细文档

项目结构

src/
  ├── config/       # 配置文件
  ├── tools/        # MCP 工具实现
  │   └── __tests__ # 工具测试
  ├── types/        # TypeScript 类型定义
  └── index.ts      # 入口文件

工具说明

getLoomers

获取 Loomers 列表,支持可选的分页、过滤和排序。

getLoomersInArea

在特定区域内获取 Loomers 的列表。

getForms

获取 Forms 列表,支持可选的分页、过滤和排序。

getFormResponses

获取 Form Responses 列表,支持可选的分页、过滤和排序。

getProjects

获取 Projects 列表,支持可选的分页、过滤和排序。

📄 许可证

本项目采用 MIT 许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端