Contactapi

io.github.kozmos-tech由 GitHub 账号 kozmos-tech 发布v0.1.1更新于 Oct 24, 2026

An open-source API for collecting and managing contacts and signups.

已验证STDIO仅桌面数据库商业与电商

概览

AI 生成的概览

Contactapi 的 MCP 服务器，基于开源的联系人与注册信息 API，让助手列出、读取、创建、更新和删除账户中的联系人。

可以做什么
分页列出并获取 Contactapi 账户中的联系人，按 ID 读取单个联系人。按邮箱创建或 upsert 联系人，附加的 JSON 字段原样保存。更新已有联系人的字段。删除联系人。所有操作都限定在你登录的账户范围内。
适用场景
当你把联系人或注册信息存放在 Contactapi，并希望助手直接查询、新增、修改或删除记录，而不必手动调用 REST API 时使用。
运行要求
需要一个 Contactapi 账户，以及支持 OAuth 2.1 动态客户端注册的客户端；需在浏览器中登录并授权，无需复制 API 密钥。README 另记录了托管端点和使用 Bearer 密钥的 REST API。
安装前请注意
这些工具可以创建、更新和删除联系人，删除后无法恢复。若创建的邮箱已存在，会就地覆盖该联系人而不是新增。授权范围覆盖整个账户，请检查助手所做的更改。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Contactapi，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

contactapi

An open-source API to save contacts. Send a POST with an email and any other JSON fields you want, and they get saved as-is. Manage them with simple CRUD.

Built with Hono and deployed on Vercel.

API overview

The base URL is https://contactapi.dev and every request carries your API key as a Bearer token:

Authorization: Bearer YOUR_KEY
MethodPathKeyDescription
POST/v1/contactssecret or publishableCreate (or upsert) a contact by email
GET/v1/contactssecretList contacts, paginated
GET/v1/contacts/:idsecretFetch a single contact
PATCH/v1/contacts/:idsecretUpdate a contact
DELETE/v1/contacts/:idsecretDelete a contact

Contacts are keyed by email — creating one whose email already exists updates it in place rather than duplicating it. Full reference lives on the landing page and in /llms.txt.

There are two kinds of key:

  • ck_secret_… — secret key, for your backend. Full access to every endpoint.
  • ck_pub_… — publishable key, for the browser. Can only create contacts and is locked to your domains.

MCP server

AI clients (Claude Desktop, claude.ai custom connectors, Cursor, the MCP Inspector) can manage your contacts through an MCP server at:

https://contactapi.dev/mcp

Auth is OAuth 2.1 with dynamic client registration — point a client at the URL and it discovers the authorization server, registers itself, and sends you to log in and approve access; no API key to copy. The server exposes five tools that mirror the REST API: list_contacts, get_contact, create_contact (upsert-by-email), update_contact, and delete_contact. Everything is scoped to the account you log in as.

The OAuth provider is Better Auth's mcp plugin (src/auth.ts); the tools and endpoint wiring live in src/mcp/server.ts and src/index.ts.

Development

Prerequisites: Vercel CLI installed globally.

bash
npm installvc devopen http://localhost:3000

Build

bash
npm installvc build

Deploy

bash
npm installvc deploy

License

MIT

来源：README.md，提交 7006be5

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分