naftiko: 1.0.0-alpha2
info:
  title: Github Mcp Vs Sdk Side By Side
  description: A comparison capability calling the same GitHub action through GitHub MCP and the Octokit SDK — exposes both surfaces side-by-side for side-by-side eval.
  tags: [Naftiko, GitHub, MCP vs SDK]
  created: '2026-05-01'
  modified: '2026-05-04'
binds:
- namespace: github-env
  keys: {GITHUB_TOKEN: GITHUB_TOKEN}
capability:
  consumes:
  - namespace: github
    type: http
    baseUri: https://api.github.com
    authentication: {type: bearer, token: '{{GITHUB_TOKEN}}'}
    resources:
    - name: repo
      path: '/repos/{{owner}}/{{repo}}'
      operations:
      - {name: get-repo, method: GET, inputParameters: [{name: owner, in: path}, {name: repo, in: path}]}
    - name: issues
      path: '/repos/{{owner}}/{{repo}}/issues'
      operations:
      - {name: list-issues, method: GET, inputParameters: [{name: owner, in: path}, {name: repo, in: path}]}
  exposes:
  - type: rest
    address: 0.0.0.0
    port: 8080
    namespace: github-mcp-vs-sdk-side-by-side-rest
    description: REST surface for the MCP-vs-SDK comparison.
    resources:
    - {name: repo, path: '/compare/{{owner}}/{{repo}}', operations: [{method: GET, name: get-repo-side-by-side, inputParameters: [{name: owner, in: path, type: string}, {name: repo, in: path, type: string}], call: github.get-repo}]}
  - type: mcp
    address: 0.0.0.0
    port: 3010
    namespace: github-mcp-vs-sdk-side-by-side-mcp
    description: MCP for the comparison.
    tools:
    - name: get-repo
      hints: {readOnly: true}
      inputParameters: [{name: owner, type: string, required: true}, {name: repo, type: string, required: true}]
      call: github.get-repo
    - name: list-issues
      hints: {readOnly: true}
      inputParameters: [{name: owner, type: string, required: true}, {name: repo, type: string, required: true}]
      call: github.list-issues
  - type: skill
    address: 0.0.0.0
    port: 3011
    namespace: github-mcp-vs-sdk-side-by-side-skills
    description: Skill for the MCP/SDK comparison.
    skills:
    - name: github-mcp-vs-sdk-side-by-side
      description: GitHub MCP vs SDK comparison.
      location: file:///opt/naftiko/skills/github-mcp-vs-sdk-side-by-side
      allowed-tools: get-repo,list-issues
      tools:
      - {name: get-repo, from: {sourceNamespace: github-mcp-vs-sdk-side-by-side-mcp, action: get-repo}}
      - {name: list-issues, from: {sourceNamespace: github-mcp-vs-sdk-side-by-side-mcp, action: list-issues}}