컨텐츠로 건너뛰기
쇼케이스 생태계 소스 코드 문서

MCP 서버

모델 컨텍스트 프로토콜 (MCP)

MCP (Model Context Protocol) 는 OpenCode의 확장성을 제공하는 오픈 표준입니다. AI 에이전트가 표준화된 방식으로 외부 도구, 데이터 소스 및 환경과 상호 작용할 수 있게 합니다.

MCP 서버를 AI에게 새로운 초능력을 주기 위해 설치할 수 있는 “스킬” 또는 “드라이버”로 생각하세요. OpenCode는 MCP 호환 서버를 모두 지원합니다.

추천 MCP 서버

With Context MCP

저장소: boxpositron/with-context-mcp

템플릿, 일괄 편집 및 무시 패턴을 갖춘 프로젝트별 마크다운 노트 관리. 에이전트가 참조할 수 있는 구조화된 프로젝트 문서를 유지 관리하는 데 완벽합니다.

  • 사용 예: “v2를 위해 결정한 API 설계 결정을 기억해 주세요” — 프로젝트 컨텍스트를 저장하고 검색
  • 설치: opencode.json MCP 서버 구성에 추가

Xquik — X/Twitter 데이터

저장소: Xquik-dev/x-twitter-scraper

MCP 서버, REST API 및 20개 추출 도구를 갖춘 X/Twitter 데이터 추출 스킬. Claude Code, Cursor, Codex 및 40개 이상의 에이전트와 함께 작동합니다.

  • 사용 예: “Twitter에서 React Server Components에 대한 최신 논의를 찾아주세요”
  • 설치: API 자격 증명과 함께 MCP 서버에 추가

MCP 음성 인터페이스

저장소: shantur/mcp-voice-interface

웹 브라우저를 통해 음성으로 AI 어시스턴트와 대화. Claude Desktop 및 OpenCode와 호환됩니다.

  • 사용 예: 핸즈프리 코딩 — 키보드 위에 손을 올린 상태에서 음성으로 지시
  • 설치: 웹 서버를 실행하고 MCP를 통해 연결

Opencode Browser

저장소: different-ai/opencode-browser

OpenCode용 브라우저 자동화 플러그인. 웹사이트를 탐색하고, DOM 요소와 상호 작용하며, 콘텐츠를 추출합니다.

  • 사용 예: “localhost:3000으로 이동하여 로그인 버튼이 작동하는지 확인하세요”
  • 설치: GitHub

인기 MCP 통합

많은 OpenCode 플러그인이 내부적으로 MCP를 사용합니다. 주요 카테고리는 다음과 같습니다:

카테고리예시설명
웹 검색Exa, Google AI Search실시간 정보를 위해 웹 검색
문서Context7공식 라이브러리 문서를 컨텍스트로 가져오기
코드 검색Grep.app공개 GitHub 저장소에서 검색
브라우저Playwright MCP, Opencode Browser브라우저 상호 작용 및 테스트 자동화
메모리Opencode Mem, With Context지속적 메모리 및 프로젝트 컨텍스트 저장

Oh My OpenAgent의 내장 MCP

Oh My OpenAgent를 사용하는 경우, 세 개의 MCP 서버가 항상 활성화되어 있습니다:

MCP기반목적
websearchExa코드, 문서, 솔루션을 위한 웹 검색
context7Context7공식 문서 조회
grep_appGrep.app공개 저장소에서 GitHub 코드 검색

구성이 필요 없습니다 — 즉시 사용 가능합니다.

MCP 서버 구성

opencode.json에 MCP 서버를 추가하세요:

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "@my-org/mcp-server"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

Oh My OpenAgent 사용자는 oh-my-openagent.json에서도 MCP 서버를 구성할 수 있습니다.

나만의 MCP 서버 개발

OpenCode는 커스텀 MCP 서버 구축을 위한 SDK를 제공합니다:

TypeScript

import { Server } from '@model-context-protocol/sdk';

const server = new Server({
  name: "my-tool",
  version: "1.0.0"
});

server.defineTool("get_data", {
  query: "string"
}, async ({ query }) => {
  return `Results for: ${query}`;
});

server.start();

Go

import "github.com/anomalyco/opencode-sdk-go/mcp"

server := mcp.NewServer("my-tool", "1.0.0")
server.Tool("get_data", "Fetch data", func(args map[string]interface{}) string {
    return "Results"
})
server.Start()

Python

from opencode_sdk import MCPServer

server = MCPServer("my-tool", "1.0.0")

@server.tool("get_data")
def get_data(query: str) -> str:
    return f"Results for: {query}"

server.start()

전체 문서는 MCP 개발자 가이드를 방문하세요.

추가 리소스