vibeprint (Efecanbasoz)

 ](https://nodejs.org)  

vibeprint

您的个人品牌，由您的代码设计而成。

vibeprint 是一个MCP服务器，可以在X和GitHub上发现您的开发人员资料，然后生成个性化的90天品牌路线图、内容主题想法，并准备发布推文副本。它使用a 提示中继 模式——每个生成步骤都会返回一个结构化的提示，让您的主机LLM完成，然后使用Zod验证并存储结果。所有内容都通过Claude Code、Gemini CLI或任何兼容MCP的客户端在本地运行。没有SaaS。没有订阅。您的数据保留在您的机器上。

______________________________________________________________________

为什么选择vibeprint？

• 基于你的实际工作 --提取您的实际GitHub存储库和X存在，而不是生成通用建议
• 快速中继，非黑匣子 --每个生成步骤都会返回一个可见的提示，您可以在保存之前进行查看、编辑或重定向
• 本地优先和私人 --状态存储在 ~/.vibeprint/ 具有限制性的文件权限。没有云帐户，没有分析，没有跟踪
• 法学硕士不可知论 --适用于任何兼容MCP的客户端：Claude Code、Gemini CLI、Cursor等

______________________________________________________________________

兼容客户端

______________________________________________________________________

快速开始

克隆和构建

git clone https://github.com/efecanbasoz/vibeprint
cd vibeprint
npm install
npm run build

配置您的MCP客户端

克劳德代码

claude mcp add vibeprint -- node /absolute/path/to/vibeprint/dist/index.js

或者手动添加到您的Claude Code MCP配置中：

{
  "mcpServers": {
    "vibeprint": {
      "command": "node",
      "args": ["/absolute/path/to/vibeprint/dist/index.js"],
      "env": {
        "GITHUB_TOKEN": "optional_for_higher_rate_limits",
        "X_BEARER_TOKEN": "optional_for_automatic_x_profile_fetch"
      }
    }
  }
}

双子星命令行工具 --添加到 ~/.gemini/settings.json:

{
  "mcpServers": {
    "vibeprint": {
      "command": "node",
      "args": ["/absolute/path/to/vibeprint/dist/index.js"],
      "env": {
        "GITHUB_TOKEN": "optional_for_higher_rate_limits",
        "X_BEARER_TOKEN": "optional_for_automatic_x_profile_fetch"
      }
    }
  }
}

替换 /absolute/path/to/ 使用克隆vibeprint的实际路径。

第一个命令

打开MCP客户端并运行：

discover_profile(x_handle: "your_handle", github_username: "your_github")

vibeprint将获取您的个人资料并告诉您下一步。

______________________________________________________________________

运作原理

discover_profile → set_niche → generate_roadmap → save_roadmap → generate_topics → save_topics → approve_topics → generate_calendar → save_calendar → export

vibeprint使用 提示中继 图案。每 generate_* 该工具根据您的当前状态构建一个结构化提示，并将其返回给主机LLM。LLM完成提示，您调用相应的 save_* 该工具在持久化JSON响应之前使用Zod验证JSON响应。您始终可以看到并控制中间提示——没有什么是不透明的。

所有工具

1. discover_profile --获取您的X bio+GitHub存储库（最多10个非分叉存储库，按最近的活动排序）
2. set_niche --定义你的细分市场、目标受众、目标和内容语言
3. generate_roadmap --为法学硕士建立90天的品牌战略提示
4. save_roadmap --验证并存储LLM的路线图JSON（3个阶段、内容支柱、里程碑）
5. generate_topics --创建一个基于你实际工作的15个内容主题想法的提示
6. save_topics --验证并存储主题
7. approve_topics --按ID选择要保留的主题
8. generate_calendar --为每个批准的主题写完整的推文副本（1-12周）
9. save_calendar --验证并存储带有日期、时间和副本的日历条目
10. export --将日历保存到 .md, .json，或 .csv
11. status --检查哪些步骤已完成，看看下一步该做什么
12. reset --清除所有状态并重新开始（需要确认）

状态保存在本地 ~/.vibeprint/ 在会议之间。

______________________________________________________________________

用法

1.发现您的个人资料

> discover_profile(x_handle: "janedoe", github_username: "janedoe")

Profile discovered and saved.

X — @janedoe
Bio: Building open-source dev tools. Prev: YC W24.
Followers: 2,340

GitHub — @janedoe
Top languages: TypeScript, Python, Go
Repos found: 8
  - fastrouter (142 ★) — High-performance HTTP router for Node.js
  - mlpipe (89 ★) — ML pipeline orchestration framework
  ...

Next step: Run set_niche to define your niche and audience.

2.确定你的定位

> set_niche(
    niche: "developer tooling and open-source",
    target_audience: "developers building with TypeScript and Node.js",
    goal: "grow to 5k followers and establish thought leadership",
    content_language: "English"
  )

Niche saved.

Niche: developer tooling and open-source
Audience: developers building with TypeScript and Node.js
Goal: grow to 5k followers and establish thought leadership
Language: English

Next step: Run generate_roadmap to build your 90-day strategy.

3.生成并保存您的路线图

> generate_roadmap()

返回LLM的详细提示。LLM生成JSON路线图，然后保存：

> save_roadmap(json: "{ ... }")

Roadmap saved.

North Star: Become the go-to voice for TypeScript developer tooling
Content Pillars:
  - Open Source Journeys (2x/week) — Behind-the-scenes of building fastrouter & mlpipe
  - Dev Tooling Tips (2x/week) — Practical TypeScript and Node.js insights
  - Founder Lessons (1x/week) — Lessons from building in public

Phases:
  Phase 1 — Foundation (Weeks 1-4): Establish voice and posting rhythm
  Phase 2 — Momentum (Weeks 5-8): Grow through threads and engagement
  Phase 3 — Authority (Weeks 9-12): Solidify thought leadership

Next step: Run generate_topics to create content ideas.

4.主题和批准

> generate_topics()
> save_topics(json: "[...]")
> approve_topics(ids: ["topic_01", "topic_03", "topic_05", "topic_07", "topic_10"])

Topics approved.

Approved (5):
  topic_01: Why I rewrote fastrouter's routing engine from scratch
  topic_03: 5 TypeScript patterns that reduced our bundle by 40%
  topic_05: What I learned mass-adopting Zod for runtime validation
  topic_07: The one Node.js debugging trick nobody talks about
  topic_10: How mlpipe went from weekend hack to 89 stars

Next step: Run generate_calendar to write the full tweet copy.

5.生成日历并导出

> generate_calendar(week_count: 4)
> save_calendar(json: "[...]")
> export(format: "md")

Calendar exported.

Format: Markdown
Entries: 16
File: ~/.vibeprint/calendar.md

______________________________________________________________________

导出格式

所有导出都保存到 ~/.vibeprint/ 默认情况下。

______________________________________________________________________

环境变量

没有这些，vibearint仍然有效-GitHub公共API未经验证即可使用，X配置文件信息可以通过 x_bio_override.

看 .env.example 对于模板。

______________________________________________________________________

隐私和安全

• 仅本地存储 --所有状态都保持不变 ~/.vibeprint/state.json。除了您明确触发的GitHub和X公共API之外，不会向任何第三方服务发送任何数据。使用模式创建的目录 0o700，使用模式写入的文件 0o600.
• Zod验证 --LLM输出的每一部分在写入状态之前都会通过严格的Zod模式进行验证。格式错误或意外的结构被拒绝。状态也在负载下进行验证；损坏的文件将被备份，并创建一个新的状态。
• 快速注射消毒 --来自X bios和GitHub仓库描述的不受信任的文本在注入提示之前会被净化（换行、长度封顶）并用显式分隔符包裹。
• CSV配方注入保护 --CSV导出支持前缀公式的字符(=, +, -, @)使用单个报价来防止电子表格公式注入。
• 路径限制 --导出路径已解析并验证为在 ~/.vibeprint/。此目录外的路径将被拒绝。
• 工具注释 --具有副作用的工具使用正确的MCP注释(destructiveHint 对于重置， readOnlyHint: false 用于导出），以便客户端可以显示适当的警告。
• 通用错误消息 -外部处理错误不会泄露内部文件路径、堆栈跟踪或API令牌详细信息。

______________________________________________________________________

堆栈

• TypeScript 5.5+ --严格模式，ES2022目标
• Node.js>=18 --使用本地 fetch，不需要聚乙烯填充物
• @modelcontextprotocol/sdk --Anthropic官方MCP SDK
• zod --所有工具输入和LLM输出的运行时模式验证
• 状态 --JSON格式的平面文件 ~/.vibeprint/ --无数据库，无云依赖

______________________________________________________________________

路线图

• \[\]v0.1--核心流（此版本）
• \[\]v0.2-通过API直接发布X（计划+发布）
• \[\]v0.3——GitHub提交→ 推特自动建议
• \[\]v0.4--条纹跟踪器+参与度分析
• \[\]v0.5--独立CLI模式（不需要MCP客户端）

______________________________________________________________________

贡献

欢迎投稿！请先打开一个问题，讨论您想更改的内容。

git clone https://github.com/efecanbasoz/vibeprint
cd vibeprint
npm install
npm run dev     # watch mode
npm test        # run tests

1. 分叉存储库
2. 创建要素分支(git checkout -b feat/my-feature)
3. 运行测试套件(npm test)
4. 提交您的更改
5. 推送到分支并打开Pull Request

______________________________________________________________________

许可证

阿帕奇-2.0

______________________________________________________________________

建造于

如果vibeprint帮助你建立了自己的品牌，那就给它一个⭐ 在X上分享你的日历！