Posy

io.github.Himanshu-Sangshetti由 GitHub 账号 Himanshu-Sangshetti 发布v2.0.0更新于 Oct 24, 2026

Make and edit a hand-made link-in-bio page: add links, pick a look, publish.

已验证Streamable HTTP可网页运行效率与工作流媒体与设计

概览

AI 生成的概览

Posy 的托管 MCP 服务器，让助手用你的账号制作、调整样式并发布一个手工风格的 link-in-bio 页面。

可以做什么
  • 读取当前草稿、公开网址和下一步建议
  • 一次性认领用户名创建页面，或从页面文件导入整页
  • 添加一个或多个链接与卡片，并修改、排序或删除
  • 设置外观、配色、字体、名字和简介，并列出可用选项
  • 发布草稿，让页面正式上线
适用场景
适合想让助手代你搭建或改造个人 link-in-bio 页面——加链接、换外观、发布——而不必在工作室里手动编辑的场景。
运行要求
远程端点 posy.page/api/mcp，使用 streamable HTTP，通过 OAuth 登录 Posy 账号（无需复制密钥）。免费账号可用基础外观，其他外观需 Pro，每月 5 美元或每年 48 美元。自建实例使用自己的网址。
安装前请注意
助手可以修改你的页面并发布，使草稿正式上线，发布前请先检查改动。发布后名字、简介、链接和邮箱会出现在公开页面上。Pro 付费功能需要花钱。REST API 另需 Agents 页面生成的 Bearer 密钥。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Posy，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.Himanshu-Sangshetti%2Fposy/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "posy": {
      "type": "http",
      "url": "https://posy.page/api/mcp"
    }
  }
}

README

[posy: a link in bio that looks like you made it by hand. A girl works at her desk on a floating island in a painted sky, with a kite flying beside her.]

Posy is a link-in-bio page that looks hand-made.

Pick a look, add your links, publish. Edit it yourself, or let your AI do it.
Free and open source. Use it at posy.page or run it yourself.

[CI] [MIT licence] [Version] [Official MCP registry] [Docs] [GitHub stars]

Website · Docs · Connect your AI · Self-host · Contributing

[Add to Cursor] [Install in VS Code] [Install in VS Code Insiders] [Add to Claude] [Install in Goose] [Set up ChatGPT]

[图片]

What is Posy

Posy is a link-in-bio page that looks hand-made. You pick a look, add your links, and publish. Edit it yourself in a calm studio, or ask your AI to do it for you. Your page is one small JSON file you can take anywhere.

[Three steps: 1, pick a look. 2, add your links, and Posy turns each one into the right tile. 3, publish to posy.page/you, or ask your AI to do all three.]

[图片]

The looks

The same links, drawn as a wooden desk with polaroids, a Japanese print, a desktop left open, a watercolour, a two-ink print or a netrunner's screen. Each look has four palettes, and you can switch any time.

[A short tour of the looks on a desktop: Desk, Washi, Lofi, Painted, Cobalt and Night.]

[Desk: a wooden desk with polaroids, a record and letters.][Washi: a Japanese print with rice paper, ink and a red seal.][Lofi: a desktop left open where every tile is a window.]
[Painted: watercolour paper, letters and wax seals.][Cobalt: a vintage print in two inks, under a crescent moon.][Night: a netrunner's screen with one signal colour.]

On posy.page, Painted, Desk and Lofi are free, and the others come with Pro. Self-hosted, every look is unlocked. See them live in the looks gallery.

See each look on a desktop
[Desk: a wooden desk with polaroids, a record and letters.][Washi: a Japanese print with rice paper, ink and a red seal.]
[Lofi: a desktop left open where every tile is a window.][Painted: watercolour paper, letters and wax seals.]
[Cobalt: a vintage print in two inks, under a crescent moon.][Night: a netrunner's screen with one signal colour.]
Tiles, palettes and layouts
TileWhat it shows
LinkFavicon, title and an optional preview image
Social29 platforms (X, Instagram, GitHub, LinkedIn, YouTube, TikTok, Bluesky, Threads, Substack…) and email
NoteShort text with bold, italic and links
SectionA heading that starts a new group of tiles
ImageYour photo or artwork, with an optional caption and link
VideoYouTube, loads only when played
MusicSpotify embed
GitHubA repo with live stars and language, refreshed daily

Three layouts: bento (a grid), list (one column) and canvas (place tiles freely). Photos can be printed natural, mono, dither or ascii. On top of each look's palettes: Cream, Lavender, Mint, Sky, Peach, Paper, Blush, Sage, Midnight, Mocha, Dusk and Ocean, any accent colour, and font pairs.

[图片]

Make your page

Claim your name at posy.page. Paste a link anywhere to add a tile, drag to arrange, and press Publish. Your page is live in a minute.

Just looking? Open posy.page/new, paste a few links and see your page before you sign up.

Free, Pro and self-hosted
posy.page Freeposy.page ProSelf-hosted
Tiles, editor, API, MCP, CLIAllAllAll
LooksPainted, Desk, LofiAllAll
Your own domainNoYes, HTTPS set up for youYes, point it at your server
AnalyticsBasic12 months + CSV12 months + CSV
"Made with Posy" footerShownHide itHide it
Setup and upkeepNoneNoneYou

Pro is $5 a month or $48 a year. Your page works the same everywhere: Settings → Download page.json on one, Import page.json on the other.

[图片]

Connect your AI

Posy has a hosted MCP server, so your AI can make and edit your page. You sign in with your Posy account; there is no key to copy. Everything it does lands in your draft, and nothing goes live until you, or it, publish.

text
https://posy.page/api/mcp

One click

[Add to Cursor] [Install in VS Code] [Install in VS Code Insiders] [Add to Claude] [Install in Goose]

A few steps

[Set up ChatGPT] [Set up Claude Code] [Set up Codex]

bash
claude mcp add --transport http posy https://posy.page/api/mcp   # Claude Code, then /mcp → Authenticatecodex mcp add posy --url https://posy.page/api/mcp               # Codex

In ChatGPT, open Plugins, press +, choose Add custom MCP server, paste the URL and pick OAuth. On your own server, use https://YOUR-POSY/api/mcp. Posy is in the official MCP registry as io.github.Himanshu-Sangshetti/posy.

No connector? Hand it a page file

Any chat can write your page as one small JSON file. Paste it at posy.page/new and it becomes a page.

[A JSON page file on the left, with name Mira Sol, look washi and a few links. An arrow points to the same page rendered in the Washi look on a phone.]

Or skip the file: an AI can hand you a link that opens a live preview, no sign-in needed.

text
https://posy.page/new?name=Mira%20Sol&look=washi&links=https://github.com/mira,[email protected]
The page file, MCP tools, REST, llms.txt and the CLI
json
{  "posy": 1,  "name": "Mira Sol",  "bio": "Writer and editor.",  "location": "Lisbon",  "look": "washi",  "links": [    "https://substack.com/@mira",    "https://x.com/mira",    "[email protected]",    { "heading": "Writing" },    "https://mira.so/letters"  ]}

Every field: the page file.

ToolWhat it does
get_pageYour draft, public URL, and what to do next
create_pageClaim a username and create your page (once)
import_pageLoad a whole page from a page file
add_tileAdd one link, or many at once. Posy picks the right tile
update_tile, move_tile, remove_tileChange, reorder or delete a tile
set_theme, set_profileLook, colours, fonts, name and bio
publishMake the draft live
list_optionsAllowed looks, palettes, fonts and sizes
SurfaceWhere
REST/api/v1/page with a Bearer key from the Agents page. Spec: /openapi.json, guide: API reference
Public JSON/api/v1/public/<username> for any published page
llms.txtposy.page/llms.txt for the app, /<username>/llms.txt for any page
Schemasschema/page.schema.json and /schema/brief.schema.json
PluginClaude Code and Cursor skills in plugin/
bash
export POSY_URL=https://posy.page POSY_API_KEY=posy_...npm run posy -- add https://github.com/owner/repo --size wnpm run posy -- theme --preset moonlit --layout listnpm run posy -- publish

Full guide: docs/ai-agents.md. Working on this repo with a coding agent? Read AGENTS.md.

[图片]

Run it yourself

[Deploy with Vercel]

Or with Docker:

bash
git clone https://github.com/Himanshu-Sangshetti/posy.git && cd posydocker build -t posy . && docker run -p 3000:3000 -v posy-data:/data \  -e NEXT_PUBLIC_SITE_URL=http://localhost:3000 -e BETTER_AUTH_URL=http://localhost:3000 \  -e BETTER_AUTH_SECRET=$(openssl rand -base64 32) posy

Open http://localhost:3000 and sign up: the first account owns the instance, and every look is unlocked. Domains, backups and every setting: self-hosting guide · .env.example

Built with

Next.js 16 · React 19 · TypeScript · Tailwind CSS 4 · Motion · dnd-kit · shadcn/ui · Better Auth · Drizzle + libSQL · Zod · MCP

One schema, src/lib/schema.ts, describes a page. It drives the JSON Schema, the REST API, the MCP tools and the editor, so they never drift apart.

How the pieces fit
mermaid
flowchart LR  studio["Studio<br/>(browser)"] --> app  agent["AI agents"] -- "MCP /api/mcp" --> app  scripts["Scripts, CLI"] -- "REST /api/v1" --> app  app["Next.js app<br/>page schema in Zod"] --> db[("SQLite or Turso<br/>(Drizzle + libSQL)")]  app --> files[("Uploads<br/>data dir or Vercel Blob")]  app --> page["/username<br/>+ llms.txt + public JSON"]
WhereWhat
src/components/page/styles/The looks, one .tsx + .css each
src/components/studio/The editor
src/app/api/REST (v1), MCP (mcp), auth and uploads
src/lib/Schema, looks, palettes, fonts, link detection

From source: npm install && npm run dev (Node 22 or 24). Your local data lives in ~/.posy.

Contributing

Issues and pull requests are welcome. Start with CONTRIBUTING.md.

  • Add a look. A look is a .tsx and a .css file plus a lab page to check it in every palette. The steps: Adding a look.
  • Pick up an issue. Good first issues and look ideas are a nice place to begin.
  • Before a PR: npm run check, npm test, and npm run e2e for UI changes.

Community, security and licence

  • Questions and ideas: issues. Please follow the Code of Conduct.
  • Found a vulnerability? See SECURITY.md and report it privately.
  • Posy is MIT licensed. The art that ships with the looks is public domain, CC0, or made for Posy; every file and its source is in public/looks/CREDITS.md. Some of it was generated with Krea 2, whose community licence allows commercial use only while your company makes under US$1M a year. Read the note in the credits file first.
  • Brand files and colours: BRAND.md.

[A painted meadow of wildflowers]

Made by hand, with a cat asleep on the desk.

来源：README.md，提交 253d020

工具

0
该服务器需要登录，因此 SourceWeft 无法在没有账号的情况下读取其工具，也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

1
  1. v2.0.0最新Oct 16, 2026

评分

已满足适用检查项的 85%

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

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

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

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