MCPs
Personal collection of MCP servers for use with Claude Code.
Servers
| Server | Directory | Tools |
|---|---|---|
| Jira | jira/ |
search_issues, get_issue |
| Confluence | confluence/ |
search_pages, get_page, list_spaces |
| GitHub | github/ |
search_repos, get_repo, get_file, list_issues, get_issue, list_pull_requests, get_pull_request, search_code |
| Ponymail | ponymail/ |
search_emails, get_email, get_list_stats, list_threads |
| Slack | slack/ |
search_messages, list_channels, get_channel_history, get_thread, get_user |
Conventions
- Runtime: Python 3.10+, managed with
uv - Framework:
FastMCPfrommcp.server.fastmcp - Transport: stdio
- Auth/config: environment variables only
- HTTP client:
httpx(async)
Claude Code integration
Add servers to your settings (global ~/.claude/settings.json or project .claude/settings.json):```json
{
"mcpServers": {
"jira": {
"command": "uv",
"args": ["run", "python", "/path/to/MCPs/jira/server.py"],
"env": {
"JIRA_BASE_URL": "https://jira.yourcompany.com",
"JIRA_PAT": "your-token"
}
},
"confluence": {
"command": "uv",
"args": ["run", "python", "/path/to/MCPs/confluence/server.py"],
"env": {
"CONFLUENCE_BASE_URL": "https://confluence.yourcompany.com",
"CONFLUENCE_PAT": "your-token"
}
},
"github": {
"command": "uv",
"args": ["run", "python", "/path/to/MCPs/github/server.py"],
"env": {
"GITHUB_PAT": "your-token"
}
},
"ponymail": {
"command": "uv",
"args": ["run", "python", "/path/to/MCPs/ponymail/server.py"],
"env": {
"PONYMAIL_BASE_URL": "https://lists.yourorg.org"
}
},
"slack": {
"command": "uv",
"args": ["run", "python", "/path/to/MCPs/slack/server.py"],
"env": {
"SLACK_TOKEN": "xoxp-your-token"
}
}
}
}
## Setup
Before using any server, install its dependencies by running `uv sync` inside that server's directory:```sh
cd jira && uv sync
cd confluence && uv sync
cd github && uv sync
cd ponymail && uv sync
cd slack && uv sync
This generates the virtual environment that uv run uses when Claude spawns the server.
Claude Desktop integration (macOS)
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (create it if it doesn't exist). The format is the same mcpServers block as above:json
{
"mcpServers": {
"jira": {
"command": "uv",
"args": ["run", "python", "/path/to/MCPs/jira/server.py"],
"env": {
"JIRA_BASE_URL": "https://jira.yourcompany.com",
"JIRA_PAT": "your-token"
}
},
"confluence": {
"command": "uv",
"args": ["run", "python", "/path/to/MCPs/confluence/server.py"],
"env": {
"CONFLUENCE_BASE_URL": "https://confluence.yourcompany.com",
"CONFLUENCE_PAT": "your-token"
}
},
"github": {
"command": "uv",
"args": ["run", "python", "/path/to/MCPs/github/server.py"],
"env": {
"GITHUB_PAT": "your-token"
}
},
"ponymail": {
"command": "uv",
"args": ["run", "python", "/path/to/MCPs/ponymail/server.py"],
"env": {
"PONYMAIL_BASE_URL": "https://lists.yourorg.org"
}
},
"slack": {
"command": "uv",
"args": ["run", "python", "/path/to/MCPs/slack/server.py"],
"env": {
"SLACK_TOKEN": "xoxp-your-token"
}
}
}
}
Replace /path/to/MCPs with the absolute path to this repo (e.g. /Users/yourname/MCPs). After saving, restart Claude Desktop for the changes to take effect.
Adding a new server
- Create a subdirectory:
/ - Add
server.py,pyproject.toml, andREADME.md - Use
@mcp.tool()to expose tools; accept all config via env vars - Run
uv lockto generate the lockfile - Update this README and
CLAUDE.md
