ipb-community

This MCP server provides a centralized interface to access tools and services related to the IPB Community through the Model Context Protocol (MCP). It exposes an 'ipb-community' server that enables retrieval and interaction with GDGOC IPB Community services such as membership checks, event listings, and basic information about GDG, GDGOC, and GDGOC IPB. In addition, it offers an unofficial IPB Community Service that leverages Retrieval-Augmented Generation (RAG) to answer questions about IPB regulations and related topics. You can connect to this MCP server from an MCP client (for example Claude Desktop) and configure the server under the mcpServers section so that the client can access these tools seamlessly. Once configured, you can initiate conversations and query the available tools to obtain structured information from the underlying services (membership status, events, organizational info, and IPB policy questions).

Prerequisites:

• Node.js installed on your device
• Git installed

Installation steps:

1. Install Node.js

   • Visit https://nodejs.org/en/download
   • Download and install the appropriate version for your OS

2. Clone the repository

   • git clone https://github.com/GDG-on-Campus-IPB-University/ipb-community-mcp-server.git
   • Navigate into the project folder: cd ipb-community-mcp-server

3. Install dependencies

   • npm install

4. Build/prepare for MCP usage

   • Ensure you have the build/index.js generated (the project typically uses a build step for the MCP server entry)

5. Configure your MCP client

   • In your MCP client (e.g., Claude Desktop), add the following configuration pointing to your local clone path: { "mcpServers": { "ipb-community": { "command": "node", "args": [ "[ROOT PATH]/ipb-community-mcp-server/build/index.js" ] } } }
   • Replace [ROOT PATH] with the absolute path to the cloned repository on your machine

6. Enable MCP tools in the client

   • Open the client’s settings and ensure the ipb-community-service tools are enabled so you can access the provided MCP endpoints

7. Run and test

   • Start the MCP server through your client or by running the entry script if desired
   • Begin a chat and issue queries like listing members, events, or IPB policy information

Optional updates:

• To update code when available, you can run: npm run update
• If update fails, repeat the installation steps from step 2

Notes and tips:

• The MCP server is named ipb-community and provides services related to GDGOC IPB Community and IPB Community (UNOFFICIAL) retrieval-based information.
• When configuring the client, ensure the root path in the config matches your local clone location exactly to avoid file path errors.
• If the MCP client cannot detect tools (ipb-community-service), verify that the server entry script (build/index.js) exists and is executable.
• Environment variables can be added under the env object in mcp_config if your deployment requires API keys or other secrets (e.g., IPB API tokens). Placeholder shown as an empty object; populate as needed.
• If you modify code, rebuild the project and restart the MCP client to reflect changes.