Sample MCP Server

# sample-serverless-mcp-server A Github MCP Server implementation based on Amazon Lambda and Streamable HTTP protocol. ## Project Description This

Local serverstdioTypeScript

What is the Sample MCP server?

Sample MCP server exists for a simple reason — assistants are far more useful when they can act on Sample directly instead of describing what you should do. # sample-serverless-mcp-server A Github MCP Server implementation based on Amazon Lambda and Streamable HTTP protocol. ## Project Description This project demonstrates how to transform the official TypeScript MCP Server to support.

What you get

  • Streamable HTTP MCP protocol support
  • Elastic deployment based on Amazon Lambda
  • Optimized cost-performance balance

What the assistant can call

Once Sample is connected, these are the calls the assistant has available:

  • OSS — Serverless CLI
  • Lambda — Executes MCP Server logic
  • Prerequisites — The Prerequisites tool exposed by this server

Configuration and credentials

You will need one environment variable: GITHUB_PERSONAL_ACCESS_TOKEN. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

  • Node.js 20+ - AWS CLI configured - OSS-Serverless CLI

Setting it up

npm on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Choosing this one

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Sample's toolset — OSS, Lambda, Prerequisites — is a fair guide to whether it matches your workflow. It is maintained by aws-samples; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the sample mcp server does with a few real requests.

Available tools

ToolWhat it does
OSSServerless CLI
LambdaExecutes MCP Server logic
PrerequisitesThe Prerequisites tool exposed by this server.

How to install the Sample MCP server

{
  "mcpServers": {
    "sample-serverless": {
      "command": "npx",
      "args": ["-y", "npm"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Node.js 20+ - AWS CLI configured - OSS-Serverless CLI
VariableDescriptionRequired
GITHUB_PERSONAL_ACCESS_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • Use Sample to OSS.
  • Use Sample to Lambda.
  • Use Sample to Prerequisites.

Frequently asked questions

It implements a GitHub MCP server that uses the Streamable HTTP protocol and can be deployed on Amazon Lambda.