Cline Community MCP Server
A Model Context Protocol server that simplifies reporting issues from Cline to GitHub.
Overview
This MCP server provides tools to streamline the process of reporting issues from Cline to the GitHub repository. It automatically gathers relevant system information (OS, Cline version, API provider, model), formats it alongside the user's issue description, and can preview how the issue would look before submitting it to GitHub.
Features
- Cross-platform support: Works on Windows, macOS, and Linux
- Multiple IDE support: Compatible with VS Code, Cursor, and Windsurf
- Automatic metadata extraction: Gets API provider, model, and IDE information from task metadata
- Two-step issue reporting workflow:
- Preview the issue before submission
- Submit to GitHub with a single command
- GitHub Integration: Uses the GitHub CLI (
gh
) to create issues
Tools
preview_cline_issue
Previews how an issue would look when reported to GitHub without actually submitting it. This should be in the autoApprove list by default
Parameters:
title
: The title for the GitHub issue (required)description
: Detailed description of the problem (required)labels
: Optional array of GitHub labels to apply
Returns: JSON object containing the formatted issue with:
- Title
- Body (including system information)
- Labels
- Target repository
report_cline_issue
Reports an issue to the GitHub repository using the locally authenticated GitHub CLI.
Parameters:
title
: The title for the GitHub issue (required)description
: Detailed description of the problem (required)labels
: Optional array of GitHub labels to apply
Returns: The URL of the created GitHub issue or an error message
Automatic Information Gathering
The server automatically collects:
- OS Information: Platform and release version
- Cline Version: Detected from installed extensions
- IDE Information: Identifies which IDE is being used (VS Code, Cursor, or Windsurf)
- API Provider: Extracted from the task metadata file
- Model: Extracted from the task metadata file
Requirements
- GitHub CLI (
gh
) installed and authenticated - Access to task metadata directories (where Cline stores information about the current task)
Installation
Clone the repo
git clone [email protected]:cline/cline-community.git
or
gh repo clone cline/cline-community
Build from Source
# Install dependencies
npm install
# Build the server
npm run build
Authenticate with GH CLI
# Log in to GitHub
gh auth login
- Select GitHub.com for where you use GitHub
? Where do you use GitHub? [Use arrows to move, type to filter]
> GitHub.com
Other
- Select HTTPS for your your preferred protocol
? What is your preferred protocol for Git operations on this host? [Use arrows to move, type to filter]
> HTTPS
SSH
- Indicate Yes that you want to authenticate
? Authenticate Git with your GitHub credentials? (Y/n)
- Select Login with a web browser
? How would you like to authenticate GitHub CLI? [Use arrows to move, type to filter]
> Login with a web browser
Paste an authentication token
- Copy your one-time code
! First copy your one-time code: XXXX-XXXX
Press Enter to open https://github.com/login/device in your browser...
Presss Enter
Login in the bowser
Enter the code that you copied
Continue
You're ready to use cline community!
Configure with Cline
Add the server to your MCP settings:
For Cline in VS Code/Cursor
Add to Cline MCP settings:
- macOS:
~/Library/Application Support/[Code|Cursor|Windsurf]/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- Windows:
%APPDATA%/[Code|Cursor|Windsurf]/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- Linux:
~/.config/[Code|Cursor|Windsurf]/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
{
"mcpServers": {
"cline-community": {
"autoApprove": [
"preview_cline_issue"
],
"timeout": 10,
"command": "node",
"args": ["/path/to/cline-community/build/index.js"],
"env": {
"GH_TOKEN": "token response received after gh auth login flow"
},
"transportType": "stdio"
}
}
}
Windows-Specific Configuration
On Windows, you may need to explicitly set the APPDATA environment variable in the MCP settings:
{
"mcpServers": {
"cline-community": {
"command": "node",
"args": ["/path/to/cline-community/build/index.js"],
"env": {
"APPDATA": "C:\\Users\\[username]\\AppData\\Roaming"
}
}
}
}
Replace [username]
with your Windows username.
Usage Example
To report an issue:
Use
preview_cline_issue
first to see how your issue will look:preview_cline_issue( title: "Feature request: Add dark mode", description: "It would be great to have a dark mode option to reduce eye strain.", labels: ["Enhancement"] )
Review the preview and then submit with:
report_cline_issue( title: "Feature request: Add dark mode", description: "It would be great to have a dark mode option to reduce eye strain.", labels: ["Enhancement"] )
Development
For development with auto-rebuild:
npm run watch
Debugging
Since MCP servers communicate over stdio, use the MCP Inspector for debugging:
npm run inspector