About shellsage-ai/mcp-server-boilerplate
shellsage-ai/mcp-server-boilerplate is an MCP server published by shellsage-ai in the Files category: ready MCP server starter templates in TypeScript and Python. Includes tool, resource, and prompt patterns with Claude Desktop integration configs.
The repository has 2 stars and 1 forks, with the last commit 7 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/shellsage-ai/mcp-server-boilerplateThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (2)
echoEcho a message back to the caller
Parameters not published.
timestampGet the current UTC timestamp
Parameters not published.
Ask AI
Ask AI about shellsage-ai/mcp-server-boilerplate
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
MCP Server Boilerplate
Production-ready starter templates for building Model Context Protocol servers in TypeScript and Python.
Skip the boilerplate. Start building tools your AI agents can actually use.
Server Capabilities
This boilerplate ships with working examples of all three MCP primitives:
Tools
| Tool | Description | Parameters |
|---|---|---|
echo |
Echo a message back to the caller | message (string, required) |
timestamp |
Get the current UTC timestamp | (none) |
Resources
| URI | Description | MIME Type |
|---|---|---|
server://info |
Server metadata (name, version, available tools) | application/json |
Prompts
No prompt templates are registered in the starter. The full kit includes prompt template patterns.
What's Included (Free)
TypeScript Quickstart
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
const server = new McpServer({
name: "my-mcp-server",
version: "1.0.0",
});
// Register a tool
server.tool("hello", { name: { type: "string" } }, async ({ name }) => ({
content: [{ type: "text", text: `Hello, ${name}!` }],
}));
// Connect via stdio
const transport = new StdioServerTransport();
await server.connect(transport);
Python Quickstart
from mcp.server import Server
from mcp.server.stdio import stdio_server
app = Server("my-mcp-server")
@app.tool()
async def hello(name: str) -> str:
"""Say hello to someone."""
return f"Hello, {name}!"
async def main():
async with stdio_server() as (read, write):
await app.run(read, write)
Claude Desktop Configuration
{
"mcpServers": {
"my-server": {
"command": "npx",
"args": ["tsx", "src/index.ts"]
}
}
}
Project Structure
my-mcp-server/
├── src/
│ └── index.ts # Server entry point
├── tools/
│ └── example.ts # Tool definitions
├── resources/
│ └── example.ts # Resource providers
├── package.json
├── tsconfig.json
└── claude_desktop_config.json
Getting Started
- Clone this repo
npm installnpm run build- Add to your Claude Desktop config
- Start building tools
Going Further
This free boilerplate gets you started. The MCP Server Boilerplate Kit ($49) includes:
- ✅ Full TypeScript + Python dual-language templates
- ✅ Docker containerization with multi-stage builds
- ✅ CI/CD pipeline (GitHub Actions) for automated testing & deployment
- ✅ SSE (Server-Sent Events) transport for web deployments
- ✅ 15+ pre-built tool examples (file ops, API calls, database queries)
- ✅ Resource and prompt template patterns
- ✅ Error handling, logging, and retry patterns
- ✅ Testing framework with mock MCP client
- ✅ Production deployment guide (Docker, systemd, cloud)
- ✅ Claude Desktop + Cursor + Windsurf integration configs
Resources
License
MIT — use this however you want.
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.