1. Conduid
  2. Content
  3. Visual Story Extension
MCP server · Content

Visual Story Extension

by · github.com/bl1nk-bot/bl1nk-studio-mcp

Canvas-first story planning system with Mermaid export

Unclaimed content
InstallView source
34Low

Scored 7 months ago · breakdown

About Visual Story Extension

Visual Story Extension is an MCP server published by bl1nk-bot in the Content category: canvas-first story planning system with Mermaid export.

The repository has 4 stars and 1 forks, with the last commit a month ago. Recent commit activity is the strongest signal that reported issues will get attention.

Install

From source
git clone https://github.com/bl1nk-bot/bl1nk-studio-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Visual Story Extension

Powered by Claude · Grounded in docs

I know everything about Visual Story Extension. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

bl1nk-visual-mcp Monorepo

ระบบวิเคราะห์และจัดระเบียบเรื่องราว (Story Analysis & Organization System)

Version: 3.0.0 | Status: Production Ready

📦 Packages

1. @bl1nk-core/visual-mcp (packages/bl1nk-core/)

Core MCP Server สำหรับวิเคราะห์ story text และสร้าง StoryGraph JSON

Tools (16 total):

Granular Tools (11 tools — recommended)

Category Tool Description
Analysis analyze_story Parse story text → StoryGraph JSON
Export export_mermaid Mermaid diagram markdown
Export export_canvas Canvas JSON (Obsidian/React Flow)
Export export_dashboard HTML dashboard (Chart.js + Tailwind)
Export export_markdown Structured Markdown document
Export export_mcp_ui_dashboard MCP-UI compatible HTML dashboard
Validation validate_story_structure 3-act structure validation
Extract extract_characters Character data from StoryGraph
Extract extract_conflicts Conflict data from StoryGraph
Extract build_relationship_graph Relationship graph
Search exa_search_story External story research (Exa AI)

Legacy Tools (4 tools — backward compat)

Tool Description
search_entries Extract entities from story text (with templates)
validate_story Quick validation from text input
generate_artifacts Generate ALL formats at once
sync_github Push files to GitHub (not implemented)

Usage:

cd packages/bl1nk-core
npm run build
npm run start

2. @bl1nk/github-sync (packages/bl1nk-sync/)

GitHub App สำหรับ sync markdown/CSV files ไป Notion อัตโนมัติ

Features:

  • Webhook handler สำหรับ GitHub push events
  • Markdown frontmatter parser
  • CSV sync ไป Notion databases
  • Relation builder

Usage:

cd packages/bl1nk-sync
npm run build
npm run start

3. bl1nk-desktop (packages/bl1nk-desktop/)

Desktop Application (React + Tauri) สำหรับดูและจัดการ story entities

Features:

  • StoryGraph visualization
  • Character relationship graph
  • Timeline view
  • Markdown preview

Usage:

cd packages/bl1nk-desktop
npm run tauri:dev

4. bl1nk-ide (packages/bl1nk-ide/)

Web IDE สำหรับ story writing และ analysis

Features:

  • Code editor สำหรับ story text
  • Real-time analysis
  • Canvas visualization
  • Markdown export

5. bl1nk-book (packages/bl1nk-book/) — ⚠️ Development

Book publishing platform (under development)

6. craft-blog-cms (packages/craft-blog-cms/) — ⚠️ Orphaned

Next.js blog/CMS — ไม่มี integration กับ core architecture Recommendation: Archive หรือแยกไป repo อื่น

🚀 Development

Install Dependencies

pnpm install

Build All

pnpm run build

Test All

pnpm run test

Develop Individual Package

cd packages/bl1nk-core
pnpm run dev  # watch mode

cd packages/bl1nk-desktop
pnpm run tauri:dev  # Tauri dev mode

cd packages/bl1nk-ide
pnpm run dev  # Vite dev server

📁 Project Structure

visual-story-extension/
├── packages/
│   ├── bl1nk-core/               # Core MCP Server & Story Analysis
│   │   ├── src/
│   │   │   ├── index.ts          # MCP server entry, tool registration
│   │   │   ├── tools/            # Tool definitions & executors
│   │   │   ├── exporters/        # Output formatters (mermaid, canvas, dashboard, markdown)
│   │   │   ├── analyzer.ts       # Story text → StoryGraph
│   │   │   ├── validators.ts     # Structural validation
│   │   │   ├── types.ts          # TypeScript interfaces
│   │   │   └── edge-cases.test.ts
│   │   ├── tests/                # Unit tests
│   │   └── package.json
│   │
│   ├── bl1nk-sync/               # GitHub → Notion sync
│   │   ├── src/
│   │   └── package.json
│   │
│   ├── bl1nk-desktop/            # Desktop UI (Tauri + React)
│   │   ├── src/
│   │   └── package.json
│   │
│   ├── bl1nk-ide/                # Web IDE (Vite + React)
│   │   ├── src/
│   │   └── package.json
│   │
│   ├── bl1nk-book/               # Book publishing platform (dev)
│   │   └── package.json
│   │
│   └── craft-blog-cms/           # ⚠️ Orphaned Next.js blog/CMS
│
├── commands/                     # Kilo CLI commands (story analysis)
├── agents/                       # Agent configurations
├── tests/                        # Integration tests
├── docs/                         # Documentation (see 📚 Documentation section)
├── TODO.md                       # Project roadmap
├── AGENTS.md                     # Root agent instructions
├── GEMINI.md                     # Gemini AI context
├── CLAUDE.md                     # Claude Code context
├── QWEN.md                       # Qwen AI context
├── package.json                  # Root package (v3.0.0)
├── pnpm-workspace.yaml
└── vitest.config.ts

📚 Documentation

Document Purpose
docs/ARCHITECTURE.md System architecture, dataflow diagrams, integration points
docs/TOOL_MAPPING.md Complete mapping of all 16 tools (schema, executor, API)
docs/PROJECT_SUMMARY.md Project history — Phase 1 (Conductor) + Phase 2 (Architecture)
docs/TAURI-APP.md Tauri app role and dependencies
docs/GITHUB-SYNC.md GitHub sync role and data flow
docs/CRAFT-BLOG-CMS.md Orphaned package decision
TODO.md Project roadmap and task tracking
AGENTS.md Root agent instructions, code style, commands
GEMINI.md Gemini AI system context
CLAUDE.md Claude Code project context
QWEN.md Qwen AI project context
packages/bl1nk-desktop/AGENTS.md Desktop app role and dependencies
packages/bl1nk-sync/AGENTS.md GitHub sync role and data flow
packages/craft-blog-cms/AGENTS.md Orphaned package decision

🔧 Configuration

MCP Client Config

{
  "mcpServers": {
    "bl1nk-core": {
      "command": "node",
      "args": ["${workspaceFolder}/packages/bl1nk-core/dist/index.js"],
      "env": {
        "EXA_API_KEY": "${env:EXA_API_KEY}"
      }
    }
  }
}

Environment Variables

packages/bl1nk-core/.env:

# EXA_API_KEY=your_exa_api_key

packages/bl1nk-sync/.env:

# GITHUB_WEBHOOK_SECRET=your_webhook_secret
# NOTION_API_KEY=your_notion_api_key
# NOTION_DATABASE_ID=your_notion_database_id

📝 License

Apache-2.0

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About Visual Story Extension

How do I install Visual Story Extension?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Visual Story Extension safe to use with an AI agent?

Its trust score is 34 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Visual Story Extension still maintained?

Yes — the last commit was a month ago. The repository has 4 stars and 1 forks.