cursor-mcp-guide
A comprehensive guide to setting up and using MCP server with Cursor IDE, including GitHub integration and AI agent configuration.
Documentation
Understanding MCP (Model Context Protocol) and GitHub Integration
What is MCP?
Model Context Protocol (MCP) is a revolutionary standardized protocol that enables AI agents to communicate seamlessly with various tools and services. Think of it like a universal translator:
- Without MCP: Each tool speaks its own language, making it difficult for AI agents to integrate with multiple tools.
- With MCP: All tools speak the same language, allowing easy integration and communication.
Real-World Analogy
Imagine having ten expert consultants, each speaking a different language:
- Without MCP: You'd need ten different translators
- With MCP: Everyone speaks a common language, making collaboration effortless
This standardization allows AI agents to:
- Connect to databases
- Interact with GitHub
- Access cloud services
- Manage files and documents
- And much more!
GitHub MCP Features
The GitHub MCP integration provides powerful capabilities for interacting with GitHub repositories:
Repository Management
- Create new repositories
- Fork existing repositories
- Clone repositories
- Manage branches
- Create and merge pull requests
Code Operations
- Search through code
- Create and edit files
- Commit changes
- Review pull requests
- Add comments and reviews
Issue Management
- Create and update issues
- Add comments to issues
- Search through issues
- Apply labels and assignees
- Track milestones
Collaboration Features
- Manage project boards
- Handle discussions
- Review comments
- Manage repository settings
- Control access permissions
Installation Guide
Prerequisites: Node.js Setup
1. Visit Node.js website
2. Download the appropriate version:
3. Run the installer and follow the prompts
Installing GitHub MCP
Method 1: Using Smithery CLI (Recommended)
npx -y @smithery/cli@latest install @smithery-ai/github \
--client cursor \
--config '{"githubPersonalAccessToken":"your_token_here"}'Method 2: Manual Configuration
1. Open `~/.cursor/mcp.json`
2. Add the following configuration:
{
"mcp_servers": {
"github": {
"command": "npx @smithery/github-mcp --token your_github_token"
}
}
}Finding MCP Servers on Smithery
1. Visit Smithery
2. Browse available MCP servers:
3. Select "GitHub MCP" from the list
4. Follow installation instructions
Adding to Cursor
Method 1: Command Line Installation
# Using Smithery CLI
npx @smithery/cli install @smithery-ai/githubMethod 2: Manual Configuration
1. Open Cursor Settings:
2. Add MCP Server:
Method 3: Direct JSON Configuration
1. Navigate to `~/.cursor/mcp.json`
2. Add server configuration manually:
{
"mcp_servers": {
"github": {
"command": "npx @smithery/github-mcp --token your_github_token"
}
}
}Using GitHub MCP
Once installed, you can use GitHub MCP to:
1. Create and manage repositories
2. Handle issues and pull requests
3. Search through code
4. Manage files and branches
5. Collaborate with team members
Frequently asked questions
What is cursor-mcp-guide?
cursor-mcp-guide is A comprehensive guide to setting up and using MCP server with Cursor IDE, including GitHub integration and AI agent configuration.
How do I install cursor-mcp-guide?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is cursor-mcp-guide open source?
Yes — it is hosted on GitHub at https://github.com/md-anbari/cursor-mcp-guide and has 2 stars.
Related MCP tools
🙌 OpenHands: Code Less, Make More for the Model Context Protocol. Enhance AI assistants with powerful integrations. Python-based implementation.
The all-in-one Desktop & Docker AI application with built-in RAG, AI agents, No-code agent builder, MCP compatibility, and more.
Universal memory layer for AI Agents; Announcing OpenMemory MCP - local and secure memory management. Python-based implementation.
基于大模型搭建的聊天机器人,同时支持 微信公众号、企业微信应用、飞书、钉钉 等接入,可选择ChatGPT/Claude/DeepSeek/文心一言/讯飞星火/通义千问/ Gemini/GLM-4/Kimi/LinkAI,能处理文本、语音和图片,访问操作系统和互联网,支持基于自有知识库进行定制企业智能客服。
:robot: The free, Open Source alternative to OpenAI, Claude and others. Self-hosted and local-first. Drop-in replacement for OpenAI, running on consumer-gra...
🍒 Cherry Studio is a desktop client that supports for multiple LLM providers. Built for the Model Context Protocol to enhance AI capabilities.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP