pipe-cd/docs-mcp-server
If you are the rightful owner of docs-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A local MCP server for searching official PipeCD docs.
PipeCD Docs MCP Server
A local MCP server for searching official PipeCD docs.
Overview
This server clones the official PipeCD docs from GitHub and provides simple full-text search and document retrieval APIs via the MCP protocol.
Documentation is cloned into a temporary directory, and Markdown files are indexed by extracting their titles and content.
Usage
Prerequisites
-
Create a PAT with
read:packages
scope. Details -
Add the following config to your
.npmrc
file.
@pipe-cd:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=YOUR_TOKEN
Cursor
Quick Install with Cursor Deeplink
For Cursor users, you can install the MCP server with a single click using the deeplink below:
This will automatically configure the MCP server in your Cursor settings. After clicking the link, Cursor will prompt you to install the server.
Install Using npx
Add the following config to your mcp.json.
{
"mcpServers": {
"pipe-cd.docs-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"@pipe-cd/docs-mcp-server@latest"
],
}
}
}
Tools
search_docs
Executes a full-text search on PipeCD docs.
- Parameters:
query
: Search keywords (space-separated, AND search)offset
: Start position for resultslimit
: Number of results to return (default: 20)
read_docs
Returns the content of the specified page.
- Parameters:
path
: Relative path of the document (after "docs/content/en/")
Implementation Notes
- Uses sparse-checkout to minimize clone size and speed up the process.
- Titles are extracted from the Markdown front matter.
- The search logic of
search_docs
is so simple for now.
Contributing
Code of Conduct
PipeCD follows the CNCF Code of Conduct. Please read it to understand which actions are acceptable and which are not.
Get Involved
- Slack:
#pipecd
channel on CNCF Slack for discussions related to PipeCD development. - Community Meeting: Every other Wednesdays. Search here.
Improvements
- Bug:
- Please open an Issue and describe the problem. Or, open a PR with if it's easy one.
- Enhancement / Feature Request:
- For small changes including docs or adding tests, please open a PR.
- For new features or big enhancement, basically, please open an Issue and discuss there before sending a PR. We cannot accept all requests in some cases.
- Security issue:
- Send an email to the core maintainers. DO NOT report on Issues.
Release Flow
- Run the
prepare release
workflow with specifing the new version. It will create a PR to update the version. - Review the PR and merge it.
- Create a Release on GitHub with a new tag.
Then, the
release package
workflow will publish a new npm package.