D0UGWITHSEISMIC/WITHSEISMIC-MCP

지엑스피1

자체 AI 도구와 프롬프트를 호스팅할 수 있는 프로덕션용 MCP 서버 템플릿입니다. 원격으로 배포하거나 로컬로 실행할 수 있으며, 인프라 문제 없이 AI 모델에 도구를 노출하려는 개발자를 위해 설계되었습니다.

://누구를_위해_이_것인가요?

이 템플릿은 다음에 적합합니다:

AI 도구 개발자 : AI 모델이 상호 작용할 수 있는 자체 도구를 빌드하고 호스팅하세요.
팀 및 조직 : AI 애플리케이션을 위한 공유 MCP 서버 설정
개별 개발자 : 프로덕션에 바로 사용할 수 있는 설정으로 MCP 개발을 빠르게 시작하세요
API 제공자 : 표준화된 인터페이스를 통해 AI 모델에 서비스를 노출합니다.

당신이 원하는 것:

🌐 여러 클라이언트가 연결할 수 있는 원격 MCP 서버를 호스팅하세요
🔧 개발 및 테스트를 위해 stdio를 통해 로컬로 실행
🚀 프로덕션에 바로 적용 가능한 MCP 구현 배포
🛠️ 인프라에 대한 걱정 없이 도구를 구축하세요

이 템플릿은 시작하는 데 필요한 모든 것을 제공합니다.

://개요

MCP 서버는 도구를 AI 모델에 노출하는 두 가지 방법을 제공합니다.

원격 서버 모드(SSE) : 여러 클라이언트가 연결할 수 있는 원격 서버로 배포
- 프로덕션 배포에 적합합니다( pnpm start:sse )
- 여러 개의 동시 연결을 지원합니다
- 철도와 같은 플랫폼에 쉽게 배포 가능
- 안전하고 확장 가능
로컬 모드(stdio) : 개발 및 테스트를 위해 로컬에서 실행( pnpm start )
- 지역 개발에 매우 좋습니다
- 직접 stdio 통신
- 빠른 반복 및 디버깅

주요 특징:

도구 : 모델이 호출할 수 있는 실행 가능한 함수
프롬프트 : 템플릿 기반 메시지 생성기
자동 검색 : 구성 요소의 자동 등록
유형 안전성 : 전체 TypeScript 지원

://이 MCP 서버 템플릿을 사용하는 이유는 무엇입니까?

모델 컨텍스트 프로토콜(MCP)은 아직 초기 단계이지만, 한 가지 분명한 것은 빠른 도입을 위해서는 원활한 개발이 필수적이라는 것 입니다. 이 구현은 개발자들이 인프라 구축이 아닌 훌륭한 도구 개발에 집중할 수 있도록 하는 데 중점을 두고 구축되었습니다.

즉시 배포

# Option 1: One-Click Deploy
Click the "Deploy on Railway" button above ☝️

# Option 2: Local Setup
pnpm install && pnpm dev

제로 마찰 개발

보일러플레이트 없음 : 도구를 정의하고 가져오기만 하면 끝입니다. 나머지는 저희가 처리합니다.
자동 등록 : 도구와 프롬프트가 자동으로 검색되어 등록됩니다.
유형 안전성 : 구성이 필요 없는 완전한 TypeScript 지원.

전투에서 테스트된 아키텍처

생산 준비 완료 : 신뢰성과 성능을 위해 제작되었습니다.
확장 가능한 디자인 : 간단한 도구부터 복잡한 AI 상호작용까지.
오류 회복성 : 강력한 오류 처리 및 디버깅 기능이 내장되어 있습니다.

개발자 경험 우선

// That's it. This is all you need to create a tool.
export const myTool = new Tool(
  {
    name: "myTool",
    description: "What my tool does",
    inputSchema: z.object({ query: z.string() }),
    outputSchema: z.object({ result: z.string() }),
  },
  async (args) => {
    // Your logic here
    return { result: "Done!" };
  },
);

우리는 다음을 처리합니다:

⚡ 연결 관리
🔄 도구 등록
🛡️ 입력 검증
📦 상태 관리
🚨 오류 처리
📊 로깅 및 메트릭

다음에 집중하세요:

🎯 놀라운 도구 만들기
🧠 강력한 프롬프트 만들기
🚀 배송 특징

://시작하기

설치

pnpm install

서버 실행

두 가지 모드를 사용할 수 있습니다.

표준 모드(stdio):

pnpm dev      # Development with hot reload
pnpm start    # Production

SSE(서버에서 보낸 이벤트) 모드:

pnpm dev:sse  # Development with hot reload
pnpm start:sse # Production

SSE 모드에서 실행하는 경우 http://localhost:3001/sse 에 연결합니다.

://핵심 개념

도구

도구는 모델이 호출할 수 있는 실행 가능한 함수입니다. 각 도구는 다음과 같습니다.

Zod를 사용하여 입력/출력 스키마를 정의했습니다.
레지스트리에 자동으로 등록됩니다
모든 작업(계산, 파일 I/O, API 호출 등)을 수행할 수 있습니다.

도구 예시:

import { z } from "zod";
import { Tool } from "../core";

const MyToolInputSchema = z.object({
  param1: z.string().describe("Parameter description"),
});

const MyToolOutputSchema = z.object({
  result: z.string().describe("Result description"),
});

export const myTool = new Tool(
  {
    name: "myTool",
    description: "What my tool does",
    inputSchema: MyToolInputSchema,
    outputSchema: MyToolOutputSchema,
  },
  async (args) => {
    const input = MyToolInputSchema.parse(args);
    // Tool logic here
    return { result: "processed result" };
  },
);

프롬프트

프롬프트는 모델 상호작용을 구성하는 데 도움이 되는 메시지 생성기입니다. 각 프롬프트는 다음과 같습니다.

인수 스키마를 정의합니다.
일관된 형식으로 메시지를 생성합니다
레지스트리에 자동으로 등록됩니다

예시 프롬프트:

import { Prompt } from "../core";

export const myPrompt = new Prompt(
  {
    name: "myPrompt",
    description: "What my prompt does",
    arguments: [
      {
        name: "arg1",
        description: "Argument description",
        required: true,
      },
    ],
  },
  async (args) => {
    return [
      {
        role: "system",
        content: {
          type: "text",
          text: `Generated message using ${args.arg1}`,
        },
      },
    ];
  },
);

://새로운 구성요소 추가

새로운 도구 만들기

src/modules/tools/ 에 새 파일을 만듭니다.
Zod를 사용하여 입력/출력 스키마를 정의하세요
도구 인스턴스를 만들고 내보내세요
src/modules/tools/index.ts 에 내보내기를 추가합니다.

레지스트리는 자동으로 다음을 수행합니다.

도구를 등록하세요
모델에 사용 가능하게 만들기
검증 및 오류 처리를 처리합니다.

새로운 프롬프트 만들기

src/modules/prompts/ 에 새 파일을 만듭니다.
인수 스키마를 정의하세요
프롬프트 인스턴스를 생성하고 내보내세요
src/modules/prompts/index.ts 에 내보내기를 추가합니다.

레지스트리는 자동으로 다음을 수행합니다.

프롬프트를 등록하세요
모델에 사용 가능하게 만들기
메시지 생성 및 오류 처리

건축학

핵심 구성 요소

레지스트리 : 모든 도구 및 프롬프트에 대한 중앙 관리자
도구 : 실행 가능한 함수의 기본 클래스
Prompt : 메시지 생성기의 기본 클래스
서버 : MCP 프로토콜 구현

자동 등록

이 시스템은 다음을 수행하는 싱글톤 레지스트리 패턴을 사용합니다.

가져오기 시 도구와 프롬프트를 자동으로 등록합니다.
구성 요소에 대한 유형 안전 액세스를 제공합니다.
모든 MCP 프로토콜 상호 작용을 처리합니다.

오류 처리

이 시스템에는 강력한 오류 처리 기능이 포함되어 있습니다.

Zod 스키마를 통한 유형 검증
실행 오류 래핑
디버깅을 위한 자세한 오류 메시지

개발

유형 안전

모든 구성 요소는 완전한 유형 안전성을 위해 TypeScript를 사용합니다.

입력/출력 스키마는 Zod를 사용하여 정의됩니다.
도구 인수 및 결과에 대한 유형 추론
포괄적인 오류 유형

테스트

다음을 사용하여 테스트를 실행합니다.

pnpm test

모범 사례

항상 명확한 입력/출력 스키마를 정의하세요
설명적인 이름과 문서를 사용하세요
오류를 우아하게 처리하세요
코드베이스에서 TypeScript 가이드라인을 따르세요

://기여

NEURAL INTERFACE DETECTED • INITIATING COLLABORATION PROTOCOLS • READY FOR UPLINK

여러분의 참여를 환영합니다! 자세한 내용은 기여 가이드를 참조하세요.

개발 워크플로
코드 스타일 가이드라인
풀 리퀘스트 프로세스
이슈 보고

다른 기여자들과 소통하고 싶으시다면 Discord 커뮤니티 에 가입하세요!

://지원하다

SUPPORT PROTOCOLS ACTIVE • COMMUNICATION CHANNELS OPEN • READY TO ASSIST

📫 이메일: hello@withseismic.com
💬 Discord: 서버에 가입하세요

://특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

WithSeismic MCP

Integrations