Woodpecker CI
A Model Context Protocol (MCP) server for Woodpecker CI, enabling seamless integration of continuous integration workflows with AI assistants.
What is Woodpecker CI?
Woodpecker CI is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol (mcp) server for woodpecker ci, enabling seamless integration of continuous integration workflows with ai assistants.
A Model Context Protocol (MCP) server for Woodpecker CI, enabling seamless integration of continuous integration workflows with AI assistants.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol (MCP) server for Woodpecker CI, ena
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx woodpeckerConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Woodpecker CI
Woodpecker MCP Server is a TypeScript MCP server that integrates AI assistants with Woodpecker CI, the open-source continuous integration platform. It exposes tools for searching repositories, listing pipelines, inspecting pipeline configurations, and retrieving step-level logs, plus a built-in AI prompt for systematic pipeline failure analysis. Development teams using Woodpecker CI can use it to debug failing pipelines, review configurations, and understand build history through natural language.
Prerequisites
- A running Woodpecker CI instance (self-hosted or cloud)
- A Woodpecker API token obtained from your profile settings under CLI & API
- Node.js and npm installed (for source builds), or Docker for container deployment
- bun installed if developing or building from source
- An MCP client such as Claude Desktop
Obtain a Woodpecker API token
Log in to your Woodpecker CI instance, navigate to your profile, and go to the CLI & API section to generate or copy your personal API token.
Clone the repository and install dependencies
Clone the woodpecker-mcp repository and install dependencies using bun.
git clone https://github.com/j04n-f/woodpecker-mcp.git
cd woodpecker-mcp
bun installBuild the server
Compile the TypeScript source to produce the runnable binary.
bun run buildConfigure environment variables
Set the two required environment variables: your Woodpecker instance URL and your API token.
export WOODPECKER_URL=https://your-woodpecker-instance.com
export WOODPECKER_TOKEN=your-woodpecker-api-tokenAdd the server to your MCP client configuration
Register the Woodpecker MCP server in your MCP client's configuration file with the required environment variables.
Woodpecker CI Examples
Client configuration
Add Woodpecker MCP Server to Claude Desktop with your instance URL and API token.
{
"mcpServers": {
"woodpecker": {
"command": "node",
"args": ["/path/to/woodpecker-mcp/dist/index.js"],
"env": {
"WOODPECKER_URL": "https://your-woodpecker-instance.com",
"WOODPECKER_TOKEN": "your-woodpecker-api-token"
}
}
}
}Prompts to try
Example prompts to manage and debug Woodpecker CI through your MCP client.
- "List all repositories connected to Woodpecker CI."
- "Show me the last 10 pipelines for the owner/my-repo repository."
- "Why did pipeline #42 fail for owner/my-repo? Show me the step logs."
- "Review the pipeline configuration for owner/my-repo and suggest improvements."
- "Identify performance bottlenecks in recent pipelines for my main repository."Troubleshooting Woodpecker CI
Authentication fails with 401 Unauthorized errors
Verify that WOODPECKER_TOKEN contains a valid token from your Woodpecker profile's CLI & API section. Tokens can expire or be revoked; generate a new one if needed and update the environment variable.
Cannot connect to Woodpecker instance
Ensure WOODPECKER_URL is set to the correct base URL of your Woodpecker CI instance including the protocol (https://). Test connectivity with 'curl https://your-woodpecker-instance.com/api/user -H "Authorization: Bearer your-token"'.
list_repositories returns an empty result
The API token must belong to a user who has access to repositories in Woodpecker. Check that the token user has been granted access to the relevant organizations and repositories in Woodpecker's admin settings.
Frequently Asked Questions about Woodpecker CI
What is Woodpecker CI?
Woodpecker CI is a Model Context Protocol (MCP) server that model context protocol (mcp) server for woodpecker ci, enabling seamless integration of continuous integration workflows with ai assistants. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Woodpecker CI?
Follow the installation instructions on the Woodpecker CI GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Woodpecker CI?
Woodpecker CI works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Woodpecker CI free to use?
Yes, Woodpecker CI is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Woodpecker CI Alternatives — Similar Developer Tools Servers
Looking for alternatives to Woodpecker CI? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Woodpecker CI in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Woodpecker CI?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.