Skip to content

added some changes based on my setup experience#5

Open
shinronin wants to merge 1 commit intoapolosan:masterfrom
shinronin:update-setup
Open

added some changes based on my setup experience#5
shinronin wants to merge 1 commit intoapolosan:masterfrom
shinronin:update-setup

Conversation

@shinronin
Copy link
Copy Markdown

Great MCP Server

Thanks for your work! After getting set up, I ran some recent tooling changes by your tools and it suggested several relevant improvements. Love it!

Summary

This PR improves the first-run setup experience based on issues encountered while setting up the project from scratch. The main changes are:

  • Add npm setup instructions alongside bun — The project currently requires bun for the prepare lifecycle script. Users without bun had no documented path forward. README, QUICKSTART, and CHANGELOG now include npm install --ignore-scripts && npx tsc as an alternative, with individual node dist/src/cli/*.js commands for database setup.

  • Fix relative path issues with Cursor and other MCP clients — Cursor does not reliably honor the cwd field for stdio MCP servers, causing "Cannot find module" and database errors when using relative paths. All config examples now use absolute paths, with an explicit callout explaining why. The ${workspaceFolder} interpolation option is documented for project-level configs.

  • Route seeder warnings through structured loggerpattern-seeder.ts used console.warn() for missing cross-references during initialization. MCP clients interpret stderr output as errors, which caused noisy false-alarm error banners in Cursor. These are now routed through logger.warn() so they respect LOG_LEVEL and write to stdout.

  • Remove committed SQLite database from repo — The 7.5 MB data/design-patterns.db binary was tracked in git. Since db:setup regenerates it, this removes it and updates .gitignore to ignore all .db files (removing the !data/design-patterns.db exception).

  • Remove unused prompts capability — The MCP server declared an empty prompts: {} capability that isn't implemented; removed to avoid confusion.

  • Expand troubleshooting section — Added specific entries for common failure modes: bun not found during npm install, Cursor "Cannot find module" errors, and MCP stderr noise from seeder warnings.

Test plan

  • bun install && bun run build && bun run db:setup still works end-to-end
  • npm install --ignore-scripts && npx tsc builds successfully without bun
  • MCP server starts with absolute paths in Cursor config
  • Seeder warnings no longer appear as errors in Cursor's MCP panel

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant