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 分