What is Nexya2a

NexyA2A is a robust MCP (Model Context Protocol) A2A server that facilitates advanced file operations, repository management, and search functionalities. It is designed for developers and analysts who seek automation and insights through modular integrations for token analytics and social sentiment analysis.

Use cases

Use cases for NexyA2A include automating the creation of branches and repositories, performing bulk file operations, conducting advanced searches across repositories, and analyzing social sentiment related to trending tokens.

How to use

To use NexyA2A, users can interact with the MCP Server via API requests. The server communicates with the GitHub API to perform various operations such as file management, repository creation, and executing search queries.

Key features

Key features of NexyA2A include automatic branch creation, comprehensive error handling, Git history preservation, support for batch operations, and advanced search capabilities for code, issues, pull requests, and users.

Where to use

NexyA2A can be utilized in software development environments, data analysis, and any application requiring automated file and repository management, as well as sentiment analysis in social media contexts.

GitHub MCP Server

Deprecation Notice:
Development for this project has been moved to github/github-mcp-server.

Overview

MCP Server for the GitHub API, enabling file operations, repository management, search functionality, and more.

Architecture

flowchart TD
    User[User/Client] -->|API Request| MCPServer[MCP Server]
    MCPServer -->|GitHub API| GitHub[GitHub]
    MCPServer -->|File Ops| FileSystem[(File System)]
    MCPServer -->|Service: nexy-cron| NexyCron[nexy-cron Service]
    MCPServer -->|Service: SocialNexy| SocialNexy[SocialNexy Service]

Features

• Automatic Branch Creation: Branches are created as needed.
• Comprehensive Error Handling: Clear error messages for common issues.
• Git History Preservation: Maintains proper Git history.
• Batch Operations: Supports single and multi-file operations.
• Advanced Search: Search code, issues/PRs, and users.

Services

• nexy-cron: Token analytics, wallet stats, trending tokens, and more.
• SocialNexy: Social sentiment, trending topics, and influencer data.

Tools

graph TD
    subgraph File & Repo
        create_or_update_file
        push_files
        get_file_contents
        create_repository
        fork_repository
        create_branch
        list_commits
    end
    subgraph Search
        search_repositories
        search_code
        search_issues
        search_users
    end
    subgraph Issues & PRs
        create_issue
        update_issue
        add_issue_comment
        create_pull_request
        get_pull_request
        list_pull_requests
        create_pull_request_review
        merge_pull_request
        get_pull_request_files
        get_pull_request_status
        get_pull_request_comments
        get_pull_request_reviews
        update_pull_request_branch
        get_issue
        list_issues
    end

• See the full list of tools and their parameters in the Tools Section.

Setup

Personal Access Token

1. Create a GitHub Personal Access Token with appropriate permissions.
2. Add it to your environment or configuration.

Usage with Claude Desktop

Docker

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "mcp/github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Build

docker build -t mcp/github -f src/github/Dockerfile .

License

MIT License. See LICENSE for details.

Diagrams

High-Level Architecture

flowchart TD
    User[User/Client] -->|API Request| MCPServer[MCP Server]
    MCPServer -->|GitHub API| GitHub[GitHub]
    MCPServer -->|File Ops| FileSystem[(File System)]
    MCPServer -->|Service: nexy-cron| NexyCron[nexy-cron Service]
    MCPServer -->|Service: SocialNexy| SocialNexy[SocialNexy Service]

Tools/Commands Overview

graph TD
    subgraph File & Repo
        create_or_update_file
        push_files
        get_file_contents
        create_repository
        fork_repository
        create_branch
        list_commits
    end
    subgraph Search
        search_repositories
        search_code
        search_issues
        search_users
    end
    subgraph Issues & PRs
        create_issue
        update_issue
        add_issue_comment
        create_pull_request
        get_pull_request
        list_pull_requests
        create_pull_request_review
        merge_pull_request
        get_pull_request_files
        get_pull_request_status
        get_pull_request_comments
        get_pull_request_reviews
        update_pull_request_branch
        get_issue
        list_issues
    end

For more details, see the full documentation or codebase.