Atlas / MCP servers / alcyone-labs / MCP TypeScript SDK

MCP TypeScript SDKBLOCK

mcp/alcyone-labs/mcp-typescript-sdk

The official TypeScript SDK for Model Context Protocol servers and clients

Verdict
BLOCK
Grade
D
Trust score
69 /100
Exposed tools
11 10r · 1w · 0d
Transport
sse · stdio · streamable-http
License
MIT
Stars
2
01

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

Important Note This is an unofficial fork upgraded to Zod V4. You can check the changes directly on the github repository

ORIGINAL version

This fork

Table of Contents

  • Overview
  • Installation
  • Quickstart
  • What is MCP?
  • Core Concepts
  • Server
  • Resources
  • Tools
  • Prompts
  • Completions
  • Sampling
  • Running Your Server
  • stdio
  • Streamable HTTP
  • Testing and Debugging
  • Examples
  • Echo Server
  • SQLite Explorer
  • Advanced Usage
  • Dynamic Servers
  • Low-Level Server
  • Writing MCP Clients
  • Proxy Authorization Requests Upstream
  • Backwards Compatibility
  • Documentation
  • Contributing
  • License

Overview

The Model Context Protocol allows applications to provide context for LLMs in a standardized way, separating the concerns of providing context from the actual LLM interaction. This TypeScript SDK implements the full MCP specification, making it easy to:

  • Build MCP clients that can connect to any MCP server
  • Create MCP servers that expose resources, prompts and tools
  • Use standard transports like stdio and Streamable HTTP
  • Handle all MCP protocol messages and lifecycle events

Installatio

Read from source at commit 001026ed50bfOBSERVED · 2026-10-12
Advertisement
02

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.

claude-code
claude mcp add modelcontextprotocol-sdk --env MCP_AUTH_PORT=${MCP_AUTH_PORT} -- npx -y @alcyone-labs/[email protected]
claude-desktop
{
  "mcpServers": {
    "modelcontextprotocol-sdk": {
      "command": "npx",
      "args": [
        "-y",
        "@alcyone-labs/[email protected]"
      ],
      "env": {
        "MCP_AUTH_PORT": "${MCP_AUTH_PORT}"
      }
    }
  }
}
03

Exposed tools (11)

10 read · 1 write · 0 destructive.

ToolRiskDescription
collect-user-inforeadA tool that collects user information through elicitation
complex-toolreadA tool with complex schema
get_weatherread
greetreadA simple greeting tool
lib.rsreadLibrary exports
list-filesread
main.rsreadPrimary application entry point
multi-greetreadA tool that sends different greetings with delays between them
start-notification-streamwriteStarts sending periodic notifications
strict-toolreadA tool with strict schema
test-toolreadA test tool
04

Trust audit

BLOCKgrade D · trust 69/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.

LayerWhat it checksResult
L0Provenance & inventoryPASS
L1Static analysis of the codeFAIL
L2Instruction surface (what it tells the agent)PASS
L3Class-specific surfacePASS
L4Behavioural (sandbox)SKIPPED

What the source does

Filesystem
none-observed
Network
declared (3 observation(s))
Shell
none-observed
Dependencies
not all pinned
Secrets in source
none-found

Findings (21)

HIGHPrivilege escalation / persistence · priv.escalate · CWE-269, CWE-250
src/client/stdio.ts:61
: /* list inspired by the default env inheritance of sudo */
Why it matters. asks for elevated privileges
LOWInventory / provenance · inv.hidden_file · CWE-1104
.git-blame-ignore-revs
.git-blame-ignore-revs
Why it matters. hidden member outside the usual dotfiles
Fix. review its purpose
LOWCode injection · code.eval_exec · CWE-78, CWE-94, CWE-95
src/examples/client/simpleOAuthClient.ts:113
exec(command, (error) => {
Why it matters. evaluates text as code
Fix. remove; use a parser or a dispatch table
LOWInformation disclosure · disclose.log_secret · CWE-209, CWE-532
src/examples/client/simpleStreamableHttp.ts:628
console.log(`Using resumption token: ${notificationsToolLastEventId || 'none'}`);
LOWInformation disclosure · disclose.log_secret · CWE-209, CWE-532
src/examples/client/simpleStreamableHttp.ts:640
console.log(`Updated resumption token: ${event}`);
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/examples/client/multipleClientsParallel.ts:1
import { Client } from '../../client/index.js';
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/examples/client/multipleClientsParallel.ts:2
import { StreamableHTTPClientTransport } from '../../client/streamableHttp.js';
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/examples/client/multipleClientsParallel.ts:8
} from '../../types.js';
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/examples/client/parallelToolCallsClient.ts:1
import { Client } from '../../client/index.js';
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/examples/client/parallelToolCallsClient.ts:2
import { StreamableHTTPClientTransport } from '../../client/streamableHttp.js';
LOWNetwork egress · net.beacon_words · CWE-200, CWE-319
src/examples/client/simpleOAuthClient.ts:21
const CALLBACK_URL = `http://localhost:${CALLBACK_PORT}/callback`;
LOWNetwork egress · net.beacon_words · CWE-200, CWE-319
src/examples/client/simpleOAuthClient.ts:219
redirect_uris: [CALLBACK_URL],
LOWNetwork egress · net.beacon_words · CWE-200, CWE-319
src/examples/client/simpleOAuthClient.ts:228
CALLBACK_URL,
LOWNetwork egress · net.raw_ip · CWE-200, CWE-319
src/client/sse.test.ts:88
resourceBaseUrl = new URL(`http://127.0.0.1:${addr.port}`);
LOWNetwork egress · net.raw_ip · CWE-200, CWE-319
src/client/sse.test.ts:124
resourceBaseUrl = new URL(`http://127.0.0.1:${addr.port}`);
LOWNetwork egress · net.raw_ip · CWE-200, CWE-319
src/client/sse.test.ts:235
resourceBaseUrl = new URL(`http://127.0.0.1:${addr.port}`);
LOWNetwork egress · net.raw_ip · CWE-200, CWE-319
src/client/sse.test.ts:462
authBaseUrl = new URL(`http://127.0.0.1:${addr.port}`);
LOWNetwork egress · net.raw_ip · CWE-200, CWE-319
src/client/sse.test.ts:494
resourceBaseUrl = new URL(`http://127.0.0.1:${addr.port}`);
LOWObfuscation / stealth · obf.decode_call · CWE-506, CWE-94
src/types.ts:469
atob(val);
LOWSupply chain · supply.unpinned · CWE-829, CWE-1357
package.json
ajv, content-type, cors, cross-spawn, eventsource, eventsource-parser, express, express-rate-limit
Why it matters. 31 dependency range(s) float
Fix. pin exact versions or ship a lockfile
INFOPrompt injection · scope.undeclared_system · CWE-94, CWE-1427
<declared scope>
system use found in code, not declared in the description
Why it matters. the description does not admit a capability the code has
Fix. declare system use in the description, or remove it

Gates applied: no_behavioural_pass.

Audited 2026-10-12 · audit v0.4.1 · source sha 001026ed50bffull audit observations/trust-audit/mcp-server/alcyone-labs__mcp-typescript-sdk.json · Report an issue / request a re-scan
05

Audit history

Every audit this server has had. A grade with a past is a grade somebody is still checking.

DateSourceVerdictGradeScoreChange
2026-10-12001026ed50bfBLOCKD69first audit
06

Questions

What is the @alcyone-labs/modelcontextprotocol-sdk MCP server?

The official TypeScript SDK for Model Context Protocol servers and clients

What tools does @alcyone-labs/modelcontextprotocol-sdk expose?

11 in total: 10 read-only, 1 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.

Is @alcyone-labs/modelcontextprotocol-sdk safe to connect to an agent?

No — not without reading the findings first. The audit graded it D (69/100) and found 1 critical or high issue in the source. Each one is listed on this page with the file and line it is on.

What credentials does @alcyone-labs/modelcontextprotocol-sdk need?

It reads MCP_AUTH_PORT from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.

How does @alcyone-labs/modelcontextprotocol-sdk run?

It speaks sse, stdio and streamable-http, so it runs as a local process your client starts. It is published on npm as @alcyone-labs/modelcontextprotocol-sdk at 1.16.0.

How current is this page?

The grade is for one exact copy of the source (001026ed50bf), read on 2026-10-12. The repository is watched and re-audited when it changes.

Advertisement