Official
Generic MCP Server
Reference generic MCP server from the official Model Context Protocol repository.
Install this MCP
Pick your client, then copy the config.
{
"mcpServers": {
"generic-mcp": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-generic"
]
}
}
}{
"mcpServers": {
"generic-mcp": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-generic"
]
}
}
}{
"servers": {
"generic-mcp": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-generic"
]
}
}
}{
"mcpServers": {
"generic-mcp": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-generic"
]
}
}
}# Add to ~/.codex/config.toml (or .codex/config.toml in a trusted project) [mcp_servers.generic-mcp] command = "npx" args = ["-y", "@modelcontextprotocol/server-generic"]
Set up with your agent
Uses the same client as above (Cursor). Paste into that agent.
Install the "Generic MCP Server" MCP for Cursor in this workspace.
1. Read official install docs: https://github.com/modelcontextprotocol/servers
2. Merge this JSON into .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):
{
"mcpServers": {
"generic-mcp": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-generic"
]
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- GITHUB_PERSONAL_ACCESS_TOKEN (required): See repository README.
4. Restart Cursor if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/generic-mcp.htmlInstall the "Generic MCP Server" MCP for Claude Desktop in this workspace.
1. Read official install docs: https://github.com/modelcontextprotocol/servers
2. Merge this JSON into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"generic-mcp": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-generic"
]
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- GITHUB_PERSONAL_ACCESS_TOKEN (required): See repository README.
4. Restart Claude Desktop if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/generic-mcp.htmlInstall the "Generic MCP Server" MCP for VS Code in this workspace.
1. Read official install docs: https://github.com/modelcontextprotocol/servers
2. Merge this JSON into .vscode/mcp.json:
{
"servers": {
"generic-mcp": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-generic"
]
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- GITHUB_PERSONAL_ACCESS_TOKEN (required): See repository README.
4. Restart VS Code if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/generic-mcp.htmlInstall the "Generic MCP Server" MCP for Windsurf in this workspace.
1. Read official install docs: https://github.com/modelcontextprotocol/servers
2. Merge this JSON into ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"generic-mcp": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-generic"
]
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- GITHUB_PERSONAL_ACCESS_TOKEN (required): See repository README.
4. Restart Windsurf if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/generic-mcp.htmlInstall the "Generic MCP Server" MCP for Codex in this workspace. 1. Read official install docs: https://github.com/modelcontextprotocol/servers 2. Merge this TOML under [mcp_servers.*] into ~/.codex/config.toml (or .codex/config.toml in a trusted project): # Add to ~/.codex/config.toml (or .codex/config.toml in a trusted project) [mcp_servers.generic-mcp] command = "npx" args = ["-y", "@modelcontextprotocol/server-generic"] 3. Required environment variables / secrets (ask the user; never invent secrets): - GITHUB_PERSONAL_ACCESS_TOKEN (required): See repository README. 4. Restart Codex if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets. Catalog: https://averlo.xyz/launches/generic-mcp.html
Try it
After install, paste one of these into your agent.
- Learn MCP protocol patterns
- Build custom MCP servers
- Understand server development

