Skip to content

Conversation

@andrelandgraf
Copy link
Contributor

This PR adds the Neon MCP server to the MCP docs.

  • add neon-mcp.md tutorial to mcp docs
  • documents two configuration setups: Remote MCP (streamable HTTP) or Local MCP (npx)
  • lists three examples prompts & outputs for illustration purposes

<Tabs groupId="interface">
<TabItem value="ui" label="Goose Desktop" default>
<GooseDesktopInstaller
extensionId="neon"
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey team, not sure if I need to register the extension somewhere else for this to work. Please let me know, happy to make the required changes :)

@blackgirlbytes
Copy link
Contributor

Hiii, thanks for the PR! As discussed, please add the following to this file documentation/static/servers.json

{
    "id": "context7",
    "name": "Context7",
    "description": "Use up-to-date code and docs",
    "command": "npx -y @upstash/context7-mcp",
    "link": "https://github.com/upstash/context7",
    "installation_notes": "Install using npx package manager.",
    "is_builtin": false,
    "endorsed": true,
    "environmentVariables": []
  },

Then @dianed-square or I can approve!

@dianed-square
Copy link
Contributor

dianed-square commented Jul 29, 2025

Hi @andrelandgraf, thanks for your contribution!

I proposed some changes to sync with the Tabs pattern we use for extensions with two install methods. Mostly I moved around your content and added some new text/structure:

  • Top-level remote and local tabs
  • Remote configuration steps section
  • Local setup TLDR tip

I also added a "local development only" warning (based on the Neon server readme) and a servers.json entry. Note that I used the local install command for now bc there seems to be an issue with streamable install links.

"id": "neon",
"name": "Neon",
"description": "Manage Neon Postgres databases, projects, and branches",
"command": "npx -y @neondatabase/mcp-server-neon start <YOUR_NEON_API_KEY>",
Copy link
Contributor

@dianed-square dianed-square Jul 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Using the local command install method until the streamable install link works. I set endorsed to false because this was listed as an experimental Neon project, but you can change it to true if it's considered stable

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks so much for the help. I swapped it to true. MCP is still very new, so we caution people to use it as the protocol and our server may change and sensible use is required for production databases but otherwise, it's definitely ready to use!

@andrelandgraf
Copy link
Contributor Author

Hi @dianed-square, thank you so much! Really appreciate it. All LGTM!

@blackgirlbytes blackgirlbytes merged commit 1c3f90c into block:main Jul 30, 2025
9 checks passed
katzdave added a commit that referenced this pull request Jul 30, 2025
* 'main' of github.com:block/goose:
  Remove unused Memory Mode / Computer-Controller Mode code (#3743)
  docs: Add Neon MCP Server tutorial (#3639)
  Update OSX codesigning and notarization (#3658)
  Fix slow typing in chat input with long running sessions (#3722)
michaelneale added a commit that referenced this pull request Jul 31, 2025
* main:
  Remove unused Memory Mode / Computer-Controller Mode code (#3743)
  docs: Add Neon MCP Server tutorial (#3639)
  Update OSX codesigning and notarization (#3658)
  Fix slow typing in chat input with long running sessions (#3722)
  Fix html content detection regex to not include markdown autolinks (#3720)
  Must have missed this one (#3733)
  Ok, well, that got out of hand (#3718)
  feat: openrouter out of the box experience for goose installations (#3507)
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.

3 participants