mcpField
C
contactapi

contactapi

本地服务
github.com/kozmos-tech商业与营销115 周前更新
代码仓库

关于 contactapi

contactapi 是用于收集和管理联系人的开源 API，以电子邮件为键支持基本 CRUD，并可保存任意 JSON 字段。它还提供 MCP 端点，经过身份验证的 AI 客户端可管理当前登录账户中的联系人。

主要功能

  1. 01按电子邮件创建或更新联系人
  2. 02分页列出联系人
  3. 03获取、更新和删除联系人
  4. 04受域名限制的浏览器发布密钥
  5. 05支持动态注册的 OAuth 2.1 MCP 访问

适用场景

  1. 01收集网站表单提交的注册信息
  2. 02更新或删除现有联系人
  3. 03让 AI 客户端管理账户联系人
  4. 04通过 REST API 集成联系人管理

MCP 相关

MCP 服务提供列出、获取、创建、更新和删除联系人的工具。客户端通过支持动态注册的 OAuth 2.1 认证，访问范围限定为已授权账户。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "kozmos-tech-contactapi": {
      "command": "npx",
      "args": [
        "-y",
        "@kozmos-tech/contactapi"
      ]
    }
  }
}
启动命令npx -y @kozmos-tech/contactapi

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@kozmos-tech/contactapi0.1.1

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

contactapi

一个用于保存联系人的开源 API。发送包含电子邮件地址和任意其他 JSON 字段的 POST 请求，这些内容就会按原样保存。通过简单的 CRUD 操作管理联系人。

使用 Hono 构建，并部署在 Vercel 上。

API 概览

基础 URL 为 https://contactapi.dev，每个请求都需携带作为 Bearer 令牌的 API 密钥：

Authorization: Bearer YOUR_KEY
MethodPathKeyDescription
POST/v1/contactssecret or publishable按电子邮件地址创建（或更新）联系人
GET/v1/contactssecret分页列出联系人
GET/v1/contacts/:idsecret获取单个联系人
PATCH/v1/contacts/:idsecret更新联系人
DELETE/v1/contacts/:idsecret删除联系人

联系人以电子邮件地址为键——如果创建的联系人使用了已存在的电子邮件地址，就会原地更新，而不会重复创建。完整参考文档请见首页和 /llms.txt。

密钥有两种：

  • ck_secret_… — 密钥，用于后端。可访问所有端点。
  • ck_pub_… — 可发布密钥，用于浏览器。只能创建联系人，并且仅限于你的域名使用。

MCP 服务

AI 客户端（Claude Desktop、claude.ai 自定义连接器、Cursor、MCP Inspector）可以通过以下位置的 MCP 服务管理联系人：

https://contactapi.dev/mcp

身份验证采用 OAuth 2.1 和动态客户端注册 — 将客户端指向此 URL，它就会发现授权服务、注册自身，并引导你登录和批准访问；无需复制 API 密钥。该服务提供五个与 REST API 对应的工具：list_contacts、get_contact、create_contact （按电子邮件地址更新或创建）、update_contact 和 delete_contact。所有操作的范围都限定为你登录的账户。

OAuth 提供方使用 Better Auth 的 mcp 插件 （src/auth.ts）；工具和端点的接线代码位于 src/mcp/server.ts 和 src/index.ts。

开发

先决条件：已全局安装 Vercel CLI。

npm install
vc dev
open http://localhost:3000

构建

npm install
vc build

部署

npm install
vc deploy

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。