TBC Guidelines Automation System
Loads and enforces 24 comprehensive TBC Bank development guidelines from Confluence, providing real-time compliance checking and automated code review against organizational standards.
Supports containerized deployment of the TBC guidelines server for consistent compliance checking across development environments.
Enables CI/CD integration for automated code review and compliance checking against TBC Bank guidelines in GitHub workflows.
Integrates with GitHub Copilot to make it TBC-aware, enabling it to generate code that automatically complies with TBC Bank development standards and guidelines.
Provides Node.js integration capabilities for embedding TBC guidelines compliance checking into JavaScript/TypeScript applications and development workflows.
Provides React component patterns and development standards enforcement through dedicated guidelines for React-based applications.
Offers TypeScript-specific coding standards and best practices enforcement as part of the comprehensive TBC Bank development guidelines.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
🏦 TBC Guidelines Automation System
Real-time TBC compliance checking + GitHub Copilot integration for your development team
Automatically enforces TBC Bank development standards with:
✅ Real-time violation detection (red squiggly lines)
✅ GitHub Copilot TBC awareness (generates compliant code)
✅ 24 comprehensive TBC guidelines loaded from Confluence
✅ Clean, direct suggestions (no verbose comments)
✅ Team-wide consistency across all projects
🎯 Team Benefits
50% fewer TBC violations in code reviews
Instant feedback while coding (no waiting for CI/CD)
Automated compliance - developers can't miss standards
Faster onboarding - new team members learn TBC patterns automatically
Related MCP server: mcp-zen-of-languages
Installation & Setup
Global Installation (Recommended)
# From the server project directory
npm run build
npm link
# Verify installation
which tbc-guidelines # Should show the global path
tbc-guidelines # Should start the server (Ctrl+C to exit)Alternative: Local Installation
npm install tbc-guidelines-mcp-serverUsage
1. Global Command Line Usage
After global installation, you can run the MCP server from any directory:
tbc-guidelinesThis starts the MCP server with stdio transport, ready to receive JSON-RPC requests.
2. Using in Other Node.js Projects
Method A: Subprocess Integration (Recommended)
Create a client in your project to communicate with the MCP server:
// guidelines-client.js
const { spawn } = require('child_process');
class GuidelinesClient {
constructor() {
this.requestId = 1;
this.server = null;
}
async start() {
// Start the global MCP server
this.server = spawn('tbc-guidelines', [], {
stdio: ['pipe', 'pipe', 'pipe']
});
// Initialize the server
await this.sendRequest('initialize', {
protocolVersion: '2024-11-05',
capabilities: {},
clientInfo: { name: 'guidelines-client', version: '1.0.0' }
});
}
async sendRequest(method, params = {}) {
return new Promise((resolve, reject) => {
const request = {
jsonrpc: '2.0',
id: this.requestId++,
method,
params
};
let response = '';
const onData = (data) => {
response += data.toString();
try {
const parsed = JSON.parse(response);
this.server.stdout.off('data', onData);
resolve(parsed.result);
} catch (e) {
// Continue reading
}
};
this.server.stdout.on('data', onData);
this.server.stdin.write(JSON.stringify(request) + '\n');
setTimeout(() => {
this.server.stdout.off('data', onData);
reject(new Error('Request timeout'));
}, 5000);
});
}
async getGuidelines() {
return await this.sendRequest('resources/list');
}
async getGuideline(uri) {
return await this.sendRequest('resources/read', { uri });
}
async reviewCode(code, language = 'typescript') {
return await this.sendRequest('tools/call', {
name: 'review_code',
arguments: { code, language }
});
}
close() {
if (this.server) {
this.server.kill();
}
}
}
// Usage example
async function main() {
const client = new GuidelinesClient();
await client.start();
try {
// List all guidelines
const guidelines = await client.getGuidelines();
console.log('Available guidelines:', guidelines.resources.map(r => r.name));
// Get a specific guideline
const guideline = await client.getGuideline('guideline://typescript-best-practices');
console.log('TypeScript Guidelines:', guideline.contents[0].text.substring(0, 200) + '...');
// Review some code
const codeReview = await client.reviewCode(`
function test() {
var x = 1;
return x;
}
`);
console.log('Code Review:', codeReview.content[0].text);
} finally {
client.close();
}
}
main().catch(console.error);Method B: Direct Package Import
If you install the package locally:
// direct-usage.js
const { McpServer } = require('@modelcontextprotocol/sdk/server/mcp.js');
const { StdioServerTransport } = require('@modelcontextprotocol/sdk/server/stdio.js');
// Import your server setup
const { setupServer } = require('tbc-guidelines-mcp-server/build/server');
async function createCustomServer() {
const server = new McpServer({
name: 'custom-guidelines-server',
version: '1.0.0'
});
await setupServer(server);
// Add your custom resources or tools here
server.setRequestHandler(ResourceListRequestSchema, async () => {
// Custom logic
});
const transport = new StdioServerTransport();
await server.connect(transport);
}3. Integration with AI/LLM Tools
Claude Desktop Integration
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"tbc-guidelines": {
"command": "tbc-guidelines"
}
}
}VS Code Extension Integration
// In your VS Code extension
const { spawn } = require('child_process');
function activateGuidelinesServer() {
const server = spawn('tbc-guidelines', [], {
stdio: ['pipe', 'pipe', 'pipe']
});
// Handle communication
server.stdout.on('data', (data) => {
// Process MCP responses
});
return server;
}4. Docker Usage
Create a Dockerfile in your project:
FROM node:18-alpine
# Install the guidelines server globally
RUN npm install -g tbc-guidelines-mcp-server
# Your app code
COPY . /app
WORKDIR /app
RUN npm install
# Start both your app and the guidelines server
CMD ["node", "your-app.js"]5. CI/CD Integration
Use in GitHub Actions or other CI systems:
# .github/workflows/test.yml
name: Test with Guidelines
on: [push, pull_request]
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- uses: actions/setup-node@v2
with:
node-version: '18'
- name: Install Guidelines Server
run: npm install -g tbc-guidelines-mcp-server
- name: Run Code Review
run: |
# Your test script that uses tbc-guidelines
node scripts/review-changes.jsAvailable Resources
guideline://typescript-best-practices- TypeScript coding standardsguideline://react-patterns- React component patternsguideline://api-design- REST API design guidelinesguideline://security-practices- Security best practicesguideline://testing-standards- Testing guidelines
Available Tools
review_code- Analyzes code against TBC guidelinesping- Health check tool
API Reference
Resources
List Resources
{
"method": "resources/list",
"params": {}
}Read Resource
{
"method": "resources/read",
"params": {
"uri": "guideline://typescript-best-practices"
}
}Tools
Review Code
{
"method": "tools/call",
"params": {
"name": "review_code",
"arguments": {
"code": "your code here",
"language": "typescript"
}
}
}Troubleshooting
Command Not Found
If tbc-guidelines command is not found after installation:
# Check if it's in your PATH
which tbc-guidelines
# Or run directly
npx tbc-guidelines-mcp-serverPermission Issues
# Make sure the binary is executable
chmod +x $(which tbc-guidelines)JSON-RPC Communication Issues
Ensure you're sending proper JSON-RPC 2.0 format
Always include
jsonrpc: "2.0",id, andmethodfieldsHandle responses asynchronously
Examples Repository
See the examples/ directory for more detailed usage examples:
simple-client.js- Basic client implementationadvanced-integration.js- Advanced usage patternsclaude-integration.md- Claude Desktop setup guide
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Governance copilot for AI-assisted coding. 72 packs, 532 rules, proof bundles.
Read-only AI coding tools for change verification, release readiness, capacity, and guidance.
30+ deterministic dev and delivery tools: linting, metrics, diagrams, model advice, AI-text checks.
Threat modeling, code/cloud/pipeline scanning, shadow-AI discovery, compliance checks and fixes.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables comprehensive security scanning of code repositories to detect secrets, vulnerabilities, dependency issues, and configuration problems. Provides real-time security checks and best practice recommendations to help developers identify and prevent security issues.21 npm2MIT
- AlicenseAqualityBmaintenanceEnables AI assistants and developers to analyze code for language-specific best practices and idiomatic patterns across programming languages, CI automation, and configuration formats.162MIT
- FlicenseNot gradedqualityDmaintenanceAutomatically enforces team coding standards in AI-assisted development by providing an MCP server that AI assistants can query for language-specific standards, style guides, and best practices.-
- AlicenseNot gradedqualityFmaintenanceProvides SDLC compliance verification as tools that AI agents can invoke, continuously monitoring and evaluating development processes.MIT