Skip to content

Conversation

@aaronsteers
Copy link
Collaborator

What

Improves the recently merged AI agents and MCP server documentation by:

  1. Adding prominent deprecation notices for the PyAirbyte Fast-Coder MCP server
  2. Adding links to official GitHub repositories for all MCP servers
  3. Making it easier for users to find the authoritative documentation for each MCP server

Requested by AJ Steers (@aaronsteers) in this Devin session.

Problem: The deprecated PyAirbyte Fast-Coder MCP server was not properly marked as deprecated in all important locations (headers, section descriptions), and none of the MCP servers had links back to their official documentation repositories.

How

Deprecation Improvements

  • Added "(Deprecated)" suffix to the Fast-Coder MCP section header in README.md
  • Enhanced the deprecation warning box with:
    • Bold text emphasizing deprecation status
    • Direct link to the recommended alternative (PyAirbyte MCP)
    • Link to GitHub Discussions for feedback

Official Documentation Links

Review guide

  1. docs/ai-agents/README.md - Verify:

    • Deprecation notice is prominent in the Fast-Coder MCP section (line 57-63)
    • Repository links are correct in the bullet points (lines 12-15)
    • "Official Documentation" sections are added for each MCP server
  2. docs/ai-agents/pyairbyte-fast-coder-mcp.md - Verify:

    • Enhanced deprecation warning clearly directs users to the alternative (lines 7-13)
    • Link to GitHub Discussions works
  3. docs/ai-agents/connector-builder-mcp.md - Verify:

    • Official documentation section added (lines 20-22)
  4. docs/ai-agents/embedded/operator-mcp/README.md - Verify:

    • Official documentation section added (lines 32-34)
  5. Test all GitHub repository links to ensure they're accessible and point to the correct repositories

User Impact

Positive:

  • Users can easily find the official documentation for each MCP server
  • Clear guidance that the Fast-Coder MCP is deprecated and what to use instead
  • Reduced confusion about which MCP server to use

No negative side effects - purely additive documentation improvements.

Can this PR be safely reverted and rolled back?

  • YES 💚

This is purely documentation changes with no code or infrastructure modifications. Rolling back would simply restore the previous documentation state.

… server docs

- Add prominent deprecation warning to PyAirbyte Fast-Coder MCP section in README
- Add links to official GitHub repositories for all MCP servers in bullet points
- Add 'Official Documentation' sections with repository links to each MCP server page
- Improve deprecation notice in pyairbyte-fast-coder-mcp.md with link to alternative
- Add GitHub Discussions link for feedback on deprecated Fast-Coder MCP

Requested by AJ Steers (@aaronsteers)

Co-Authored-By: AJ Steers <[email protected]>
@github-actions
Copy link
Contributor

👋 Greetings, Airbyte Team Member!

Here are some helpful tips and reminders for your convenience.

Helpful Resources

PR Slash Commands

Airbyte Maintainers (that's you!) can execute the following slash commands on your PR:

  • /format-fix - Fixes most formatting issues.
  • /bump-version - Bumps connector versions.
    • You can specify a custom changelog by passing changelog. Example: /bump-version changelog="My cool update"
    • Leaving the changelog arg blank will auto-populate the changelog from the PR title.
  • /run-cat-tests - Runs legacy CAT tests (Connector Acceptance Tests)
  • /build-connector-images - Builds and publishes a pre-release docker image for the modified connector(s).
  • JVM connectors:
    • /update-connector-cdk-version connector=<CONNECTOR_NAME> - Updates the specified connector to the latest CDK version.
      Example: /update-connector-cdk-version connector=destination-bigquery
    • /bump-bulk-cdk-version type=patch changelog='foo' - Bump the Bulk CDK's version. type can be major/minor/patch.
  • Python connectors:
    • /poe connector source-example lock - Run the Poe lock task on the source-example connector, committing the results back to the branch.
    • /poe source example lock - Alias for /poe connector source-example lock.
    • /poe source example use-cdk-branch my/branch - Pin the source-example CDK reference to the branch name specified.
    • /poe source example use-cdk-latest - Update the source-example CDK dependency to the latest available version.

📝 Edit this welcome message.


Please use the [PyAirbyte MCP](./pyairbyte-mcp.md) instead, which provides a local MCP server for managing Airbyte connectors through AI assistants.

If you would like to see continued development on this tool, please let us know by adding feedback on the [PyAirbyte GitHub Discussions](https://github.com/airbytehq/PyAirbyte/discussions).
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ [vale] reported by reviewdog 🐶
[Google.We] Try to avoid using first-person plural like 'us'.

@devin-ai-integration
Copy link
Contributor

Original prompt from AJ Steers
@Devin - Can you locate the recently merged docs about AI agents and MCP servers? I believe the deprecated server is not properly noted as such in all the important headers and bullet points that reference it. And I think in all cases, we might be missing links back to the best docs page per each MCP server. We should make sure that we prominently link to the official docs of each
Thread URL: https://airbytehq-team.slack.com/archives/D089P0UPVT4/p1761169650149479?thread_ts=1761169650.149479

@devin-ai-integration
Copy link
Contributor

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

Change 'let us know' to 'share feedback' to comply with Google style guide

Co-Authored-By: AJ Steers <[email protected]>
@github-actions
Copy link
Contributor

Deploy preview for airbyte-docs ready!

✅ Preview
https://airbyte-docs-6f0bbi9tc-airbyte-growth.vercel.app

Built with commit 3860531.
This pull request is being automatically deployed with vercel-action

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.

2 participants