MCP (Message Control Program) Servers

This repository contains a collection of MCP servers that provide interfaces to various services and APIs. Each server is designed to be used with Cursor IDE through symbolic links.

Structure

mcp/
├── AI_README.md        # Instructions for AI agents on Python best practices
├── README.md          # This file
├── github/           # GitHub API server
│   ├── server.py    # Main server implementation
│   └── ...
└── gmail/           # Gmail API server
    ├── server.py    # Main server implementation
    └── ...

Servers

GitHub Server

• Manages GitHub repositories
• Handles SSH key authentication
• Supports repository creation, deletion, and listing
• Uses GitHub API tokens for enhanced functionality

Gmail Server

• Interfaces with Gmail API
• Supports reading and sending emails
• Uses OAuth 2.0 for authentication
• Provides search functionality

Setup

Each server is symbolically linked to the Cursor IDE configuration directory:

~/.cursor/servers/github -> ~/mcp/github
~/.cursor/servers/gmail -> ~/mcp/gmail

Development

• All Python development follows the guidelines in AI_README.md
• Uses uv for Python package management
• Each server maintains its own virtual environment and dependencies

Security

• API tokens and credentials are stored securely
• OAuth 2.0 tokens are used where applicable
• Sensitive data is never committed to version control

Contributing

When adding a new MCP server:

1. Create a new directory in ~/mcp
2. Follow the Python project structure from AI_README.md
3. Create a symbolic link in ~/.cursor/servers
4. Update this README with server details

License

MIT License - Feel free to use and modify as needed.