convez.ai
MCP ServerIntegração & APIsIntermediário
kasimmj

MCP Genesis

kasimmj/mcp-genesis

Starter kit MCP multi-linguagem com scaffold automático em 3 idiomas

Ver no GitHub
BomPluginScore · de 0 a 100

Kit de inicialização completo para construir servidores MCP (Model Context Protocol) em Python, TypeScript ou Go. Fornece scaffolding production-ready com exemplos funcionais, testes, Docker e configuração Claude Desktop pré-pronta.

Instalação

$npx convez-ai kasimmj/mcp-genesis

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
85%
Último commit
há 6 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Criar novos servidores MCP rapidamente sem boilerplate
  • Aprender padrões de implementação MCP comparando Python, TypeScript e Go
  • Integrar dados e APIs customizadas com Claude via MCP

Veredito

Referência sólida para quem quer construir servidores MCP. O diferencial é oferecer três implementações idênticas em paralelo, ideal para aprender o protocolo ou escolher a linguagem mais adequada ao seu caso. Bem estruturado com exemplos funcionais.

README

A tradução para o português deste README ainda está na fila.

Stop boilerplate. Start building. mcp-genesis is the only starter kit that gives you a fully-working MCP server in three languages, with the same tool definitions, the same conventions, and the same genesis new command to scaffold yours.

What is MCP? • Quick Start • Languages • Compare


🤔 What is MCP?

The Model Context Protocol (MCP) is the open standard for connecting AI assistants to data sources, tools, and APIs. Think of it as USB-C for AI — a single port that lets any LLM talk to anything.

This repo gives you production-ready scaffolding to build your own MCP server in Python, TypeScript, or Go.


⚡ Quick Start

Scaffold a new server (any language)

npx mcp-genesis new my-server --lang python
npx mcp-genesis new my-server --lang typescript
npx mcp-genesis new my-server --lang go

You get a complete project with:

  • ✅ Three working example tools
  • ✅ stdio + SSE transports configured
  • ✅ Auth middleware stub
  • ✅ Structured logging
  • ✅ Tests
  • ✅ Dockerfile
  • ✅ One-line Claude Desktop config example

Or clone and study

git clone https://github.com/kasimmj/mcp-genesis
cd mcp-genesis/python && python -m mcp_genesis.server
cd mcp-genesis/typescript && npm install && npm run dev
cd mcp-genesis/go && go run ./cmd/genesis

📂 Repo Layout

mcp-genesis/
├── python/             # Reference server in Python
│   ├── mcp_genesis/
│   │   ├── server.py
│   │   ├── tools.py
│   │   └── transports.py
│   └── pyproject.toml
├── typescript/         # Reference server in TypeScript
│   ├── src/
│   │   ├── server.ts
│   │   ├── tools.ts
│   │   └── transports.ts
│   └── package.json
├── go/                 # Reference server in Go
│   ├── cmd/genesis/
│   └── go.mod
├── templates/          # Skeleton templates used by `genesis new`
├── examples/           # Real-world example servers
└── docs/               # Protocol notes, design decisions

All three implementations expose the same three example tools, so you can compare implementations apples-to-apples.


🛠️ Built-in Example Tools

ToolWhat it does
echoReturns the input string. Useful smoke test.
nowReturns the current ISO-8601 timestamp + timezone.
read_fileReads a file path with path-traversal protection and 1 MB cap.

Each tool is implemented identically across all three languages.


🌐 Supported Languages

🐍 Python

from mcp_genesis import Server, tool

server = Server(name="genesis", version="0.1.0")

@tool
def echo(text: str) -> str:
    """Return the input string unchanged."""
    return text

if __name__ == "__main__":
    server.run_stdio()

🟦 TypeScript

import { Server, tool } from "mcp-genesis";

const server = new Server({ name: "genesis", version: "0.1.0" });

server.addTool(tool({
  name: "echo",
  description: "Return the input string unchanged.",
  parameters: { text: { type: "string" } },
  handler: ({ text }) => text,
}));

server.runStdio();

🐹 Go

package main

import "github.com/kasimmj/mcp-genesis/go/pkg/genesis"

func main() {
    s := genesis.New("genesis", "0.1.0")
    s.AddTool(genesis.Tool{
        Name: "echo",
        Description: "Return the input string unchanged.",
        Handler: func(args map[string]any) (any, error) {
            return args["text"], nil
        },
    })
    s.RunStdio()
}

🔀 Side-by-side

PythonTypeScriptGo
Bundle size~150 KB~80 KB~5 MB (binary)
Cold start~80 ms~120 ms~5 ms
Best forData tools, AI utilsWeb integrationsHigh-throughput, edge
Auth helpers✅✅✅
Stdio transport✅✅✅
SSE transport✅✅✅
Docker imagepython:3.12-slimnode:20-alpinescratch + binary

Pick the one that matches your team's stack. The protocol is the same; the ergonomics differ.


🧪 Connect to Claude Desktop

After running your server, add this to your Claude Desktop config:

{
  "mcpServers": {
    "genesis-python": {
      "command": "python",
      "args": ["-m", "mcp_genesis.server"]
    }
  }
}

Restart Claude Desktop → your tools appear in the picker.


📚 Docs


🤝 Contributing

We're looking for:

  • New examples in examples/ (database connectors, SaaS integrations, file utils)
  • Bug reports for any of the three reference implementations
  • Translations of docs

See CONTRIBUTING.md.


📜 License

MIT © 2026 Kasim Mohammed


Star ⭐ to bookmark for your next MCP project.

Ver o original no GitHub

Bom para

Relacionados