A Model Context Protocol (MCP) 서버는 Effect 생태계에서 가장 현재 문서화에 전념합니다.

목적

이 MCP 서버는 AI 조수 및 도구에 대한 효과 문서에 실시간 액세스를 제공합니다. VS Code Extensions 및 기타 MCP 클라이언트가 정확하고 최신의 Effect Package 문서를 검색하여 개발자가 질문에 대한 답을 제공합니다.

• 핵심 effect 패키지
• 생태계 패키지 (@effect/platform, @effect/ai 등)
• 둘 다 안정되어 있고는 불안정한 효력 포장

서버 지능적으로 코드를 가져 오기 효과 패키지를 감지하고 쿼리에 대한 가장 관련 문서를 fetches.

특징

• 효과 생태계의 실시간 문서 접근
• 안정적이고 실험적인 패키지 모두 지원
• 수입품에 근거를 둔 Context-aware 포장 탐지
• VS Code 및 기타 MCP 호환 클라이언트와의 원활한 통합
• API 사용 질문에 대한 답변

이 서버가 노출되는 것

• 자료 (preferred)
• 동적 템플릿: [T3]
• {libId} 및 리소스 목록 지원

@niklaserik/effect-mcp

A Model Context Protocol (MCP) server dedicated to fetching the most current documentation from the Effect ecosystem.

Purpose

This MCP server provides real-time access to Effect documentation for AI assistants and tools. It enables VS Code extensions and other MCP clients to retrieve accurate and up-to-date Effect package documentation to assist developers with questions about:

• The core effect package
• Ecosystem packages (@effect/platform, @effect/ai, etc.)
• Both stable and unstable Effect packages

The server intelligently detects imported Effect packages in your code and fetches the most relevant documentation to answer your queries.

Features

• Real-time documentation access for Effect ecosystem
• Support for both stable and experimental packages
• Context-aware package detection based on imports
• Seamless integration with VS Code and other MCP-compatible clients
• Helps answer API usage questions for Effect developers

What this server exposes

• Resources (preferred)
  • Dynamic template: effect-docs://{libId}
  • Completions on {libId} and resource listing are supported
  • Static aliases for discovery: effect-docs://effect, effect-docs://@effect-platform, etc.
  • Supported libraries (as of now):
    • effect
    • @effect/platform
    • @effect/sql
    • @effect/vitest
    • @effect/ai
    • @effect/cli
    • @effect/cluster
    • @effect/rpc
    • @effect/typeclass
• Tools (for compatibility)
  • effect-documentation: fetch docs for selected libraries and return concatenated markdown
  • effect-doc-links: return plain URIs to the resources above so clients can follow them

Caching & Retry

• In-memory TTL cache (~10 minutes) to avoid refetching unchanged docs.
• Lightweight retry with small backoff on transient fetch errors.

Installation

pnpm add @niklaserik/effect-mcp

Usage

For usage in VS Code or other MCP clients, refer to the client’s documentation for adding custom MCP servers.

Quick test locally:

pnpm install
pnpm build
node dist/index.js # stdio transport

Then connect with an MCP client (e.g., MCP Inspector) over stdio and try:

• List resources and read effect-docs://effect
• Call tool effect-doc-links with { "libraries": ["effect", "@effect/platform"] }

Initialization instructions

• The server publishes short usage instructions via MCP initialize for clients that display them.

Development

# Install dependencies
pnpm install

# Build the project
pnpm build

# Run in development mode with auto-reload
pnpm dev

Notes:

• Built with @modelcontextprotocol/sdk@^1.17.4 using the modern registerResource/registerTool APIs.
• Transport: stdio by default; can be adapted to Streamable HTTP if needed.

License

MIT