MCP Crypto Server

It is an MCP server written in Kotlin that provides information, analysis, news, and more related to cryptocurrency and financial using the Model Context Protocol (MCP). This project was developed to provide cryptocurrency news and coins prices to LLM surfaces in a standardized manner using the MCP protocol.

Example Usage

https://github.com/user-attachments/assets/f95ad266-8c3e-45f0-850e-e63f570053f2

Features

• MCP protocol-compliant server
• Presentation of crypto-related information
• Presentation economic events, stock overview, income statement, cash flow and etc. about financial-related information
• Communication via Stdio
• Easy expandability

Installation

Add the new repository to your build file:

repositories {
    mavenCentral()
}

Quick Start

Creating a Client

import io.modelcontextprotocol.kotlin.sdk.client.Client
import io.modelcontextprotocol.kotlin.sdk.client.StdioClientTransport
import io.modelcontextprotocol.kotlin.sdk.Implementation

val client = Client(
    clientInfo = Implementation(
        name = "example-client",
        version = "1.0.0"
    )
)

val transport = StdioClientTransport(
    inputStream = processInputStream,
    outputStream = processOutputStream
)

// Connect to server
client.connect(transport)

// List available resources
val resources = client.listResources()

// Read a specific resource
val resourceContent = client.readResource(
    ReadResourceRequest(uri = "file:///example.txt")
)

Creating a Server

import io.modelcontextprotocol.kotlin.sdk.server.Server
import io.modelcontextprotocol.kotlin.sdk.server.ServerOptions
import io.modelcontextprotocol.kotlin.sdk.server.StdioServerTransport
import io.modelcontextprotocol.kotlin.sdk.ServerCapabilities

val server = Server(
    serverInfo = Implementation(
        name = "example-server",
        version = "1.0.0"
    ),
    options = ServerOptions(
        capabilities = ServerCapabilities(
            resources = ServerCapabilities.Resources(
                subscribe = true,
                listChanged = true
            )
        )
    )
)

// Add a resource
server.addTool(
        name = "example-tool",
        description = "Example Description",
        inputSchema = Tool.Input(
            properties = buildJsonObject { },
            required = emptyList()
        )
    ) { _ ->
        val newsList = runBlocking { httpClient.getExample(apiKey) }
        CallToolResult(
            content = exampleList.map {
                TextContent("""
                    Title: ${it.title}
                    Description: ${it.description}
                    URL: ${it.url}
                    Thumbnail: ${it.thumbnail}
                    Created At: ${it.createdAt}
                """.trimIndent())
            }
        )
    }

// Start server with stdio transport
val transport = StdioServerTransport()
server.connect(transport)

Usages

You need an API key to run the project. Get an API key from RapidAPI and replace YOUR_API_KEY in the McpCryptoServer.kt file with your own key.

Run Project:

Click installDist ->

After Create build file left side -> You can integrate your mcp server into any ai tool by right-clicking on the relevant server and copying the path.

Usage your Path any AI Tool MCP inside and add this code ->

{
   "mcpServers": {
       "mcp-crypto-service-server": {
           "command": "Your MCP Server Path",
           "args": []
       }
   }
}

🚀 Contributing

Contributions are welcome! 🎉 Feel free to fork the repository and submit a Pull Request with improvements.

Steps to Contribute:

1. Fork the repo 🍴
2. Create a new branch 🚀 (git checkout -b feature-name)
3. Commit changes 🎯 (git commit -m 'Add feature XYZ')
4. Push to the branch 📤 (git push origin feature-name)
5. Open a Pull Request 🔥

---

📝 License

This project is open-source and available under the MIT License.

---

💡 Looking for feedback & collaboration! If you're passionate about Android architecture, feel free to connect. 🚀