Storylenses

io.github.benediktgirz由 GitHub 帳號 benediktgirz 發布v0.1.3更新於 Oct 24, 2026

AI cover letter generation for agents. Job analysis, profile matching, narrative letters.

已驗證Streamable HTTP可網頁執行效率與工作流AI 與機器學習

概覽

AI 產生的概覽

StoryLenses 讓助理分析職缺、將履歷與職缺比對，並產生與評分故事化的求職信。

可以做什麼
  • 把職缺內容解析成 15 個以上的結構化欄位
  • 將求職者履歷與職缺分析結果進行比對
  • 依選定的敘事原型與語氣產生故事化求職信
  • 對完成的求職信進行評分與評估
  • 列出可用的敘事原型與語氣
適用情境
適合在協助求職時使用：把職缺轉成結構化資料、評估履歷與職缺的契合度，以及撰寫與檢視量身打造的求職信。
執行需求
需要 StoryLenses API 金鑰：遠端端點透過 Authorization bearer 標頭傳送，本機 npm 套件（npx @storylenses/mcp-server）或 Docker 映像則以環境變數 STORYLENSES_API_KEY 提供。可選的 STORYLENSES_API_URL 可覆寫 API 基礎網址。需要能連線至 StoryLenses 服務的網路。
安裝前請注意
API 金鑰屬於機密且為必要，請勿放入共用設定。用量依付費方案計量（免費版每月 10 次產生，付費方案為每月 29 美元與 99 美元），呼叫會消耗額度或產生費用。送出的職缺資訊與履歷文字會傳送至 StoryLenses 服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Storylenses，將其新增到工作區。
  2. 連接 Authorization token 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.benediktgirz%2Fstorylenses/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "storylenses": {
      "type": "http",
      "url": "https://www.storylenses.app/api/mcp/endpoint",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

StoryLenses MCP Server

AI-powered cover letter generation for MCP-compatible agents. The first production MCP server for job applications.

Tools

ToolDescription
storylenses_analyze_jobExtract 15+ structured fields from a job posting
storylenses_match_profileMatch a candidate CV against job data
storylenses_generate_letterGenerate a story-driven cover letter
storylenses_quality_checkScore and evaluate a cover letter
storylenses_list_archetypesList available narrative archetypes and tones

Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

json
{  "mcpServers": {    "storylenses": {      "command": "npx",      "args": ["-y", "@storylenses/mcp-server"],      "env": {        "STORYLENSES_API_KEY": "your-api-key"      }    }  }}

Cursor / VS Code

Add to .cursor/mcp.json or VS Code MCP settings:

json
{  "mcp": {    "servers": {      "storylenses": {        "command": "npx",        "args": ["-y", "@storylenses/mcp-server"],        "env": {          "STORYLENSES_API_KEY": "your-api-key"        }      }    }  }}

Docker

bash
docker run -e STORYLENSES_API_KEY=your-key ghcr.io/benediktgirz/storylenses-mcp-server

Environment Variables

VariableRequiredDescription
STORYLENSES_API_KEYYesYour API key from storylenses.app/mcp
STORYLENSES_API_URLNoAPI base URL (default: https://www.storylenses.app)

Example Workflow

typescript
// 1. Analyze job postingconst job = await callTool("storylenses_analyze_job", {  job_url: "https://linkedin.com/jobs/view/12345"});
// 2. Match candidate profileconst match = await callTool("storylenses_match_profile", {  job_analysis: job,  candidate_cv: "Senior engineer with 7 years React experience..."});
// 3. Generate cover letterconst letter = await callTool("storylenses_generate_letter", {  job_analysis: job,  match_data: match,  candidate_name: "Alex Chen",  archetype: match.suggestedArchetype});
// 4. Quality checkconst score = await callTool("storylenses_quality_check", {  letter_text: letter.letter_text,  job_analysis: job});

Testing

bash
npm installSTORYLENSES_API_KEY=your-key npm test

Get an API Key

Visit storylenses.app/mcp to get your API key.

  • Free: 10 generations/month
  • Developer ($29/mo): 200 generations
  • Scale ($99/mo): 1,000 generations

License

MIT

來源：README.md，提交 a93a496

工具

0
該伺服器需要 API 金鑰等憑證，因此 SourceWeft 無法在沒有憑證的情況下讀取其工具，也未收錄。

版本歷史

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

評分

已滿足適用檢查項的 60%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分